Gauge Chart in C#
Render semi-circular gauge charts in C# with AddGauge — one KPI against its range, as self-contained SVG. Embeds into PDF, HTML, and Word reports.
Gauge / Radial Chart
ChartType.Gauge — semi-circular dial.
When to use a gauge chart
Reach for it when
- One value against a known, meaningful range — SLA attainment, capacity used, a score out of 100.
- Dashboard tiles where the reader needs "are we in the green?" at a glance.
- Cases where the range boundaries carry as much meaning as the value.
Use something else when
- A value with no natural maximum. Without a real ceiling the needle position is arbitrary.
- Comparing several gauges. Five dials in a row is harder to read than one bar chart of the same five values.
- Precise readings — a dial is a coarse instrument; print the number alongside it.
Gauge Chart in C#
Lifted verbatim from the chart types reference, so it compiles against the shipped API. See the API reference for every overload and the exact data types each series method accepts.
string svg = ChartBuilder.Create()
.Title("Server CPU Utilisation")
.Size(460, 360)
.YAxis(y => { y.Min = 0; y.Max = 100; })
.AsAnimated()
.Series(s => s
.AddGauge("CPU %", 67, cfg => cfg.Color(ChartColor.ChartBlue)))
.RenderToSvg();Install
dotnet add package TerraFluent.Chart.Reporting
- MIT licensed — free for commercial use, no chart limits, no watermarks.
- Zero dependencies — nothing but the .NET base class library.
- netstandard2.0 through net10.0 — .NET Framework 4.6.1+, .NET Core 2.0+, and every modern release.
- Output is one SVG string — embed it in HTML, a PDF, or a Word document.