A chart series that displays data as vertical columns (bars) in a RadzenChart. RadzenColumnSeries is ideal for comparing values across categories or showing trends over time with discrete data points. Renders vertical rectangles where the height represents the data value. Multiple column series in the same chart are displayed side-by-side for each category. Supports fill color/stroke color/width customization with individual column colors via Fills/Strokes, dynamic coloring based on value ranges using FillRange and StrokeRange, optional value labels on top of columns, interactive tooltips showing category/value/series name, and click event handling for drill-down scenarios. Use CategoryProperty to specify the X-axis field and ValueProperty for the column height (Y-axis value).
CartesianSeries<TItem>.RequireChart
CartesianSeries<TItem>.ComposeCategory
CartesianSeries<TItem>.ComposeValue
CartesianSeries<TItem>.IsValueNullable
CartesianSeries<TItem>.GetRawValueGetter
CartesianSeries<TItem>.IsNumeric
CartesianSeries<TItem>.GetCategories
CartesianSeries<TItem>.TransformCategoryScale
CartesianSeries<TItem>.TransformValueScale
CartesianSeries<TItem>.RenderOverlays
CartesianSeries<TItem>.SetParametersAsync
CartesianSeries<TItem>.Initialize
CartesianSeries<TItem>.MeasureLegend
CartesianSeries<TItem>.InsidePolygon
CartesianSeries<TItem>.RenderTooltip
CartesianSeries<TItem>.RenderSharedTooltipItem
CartesianSeries<TItem>.GetTooltipPosition
CartesianSeries<TItem>.TooltipClass
CartesianSeries<TItem>.RenderLegendItem
CartesianSeries<TItem>.GetMedian
CartesianSeries<TItem>.GetMean
CartesianSeries<TItem>.GetMode
CartesianSeries<TItem>.GetTrend
CartesianSeries<TItem>.GetTitle
CartesianSeries<TItem>.TooltipLabel
CartesianSeries<TItem>.TooltipTitle
CartesianSeries<TItem>.TooltipValue
CartesianSeries<TItem>.PickColor
CartesianSeries<TItem>.Dispose
CartesianSeries<TItem>.InvokeClick
CartesianSeries<TItem>.ChildContent
CartesianSeries<TItem>.TooltipTemplate
CartesianSeries<TItem>.Overlays
CartesianSeries<TItem>.CoordinateSystem
CartesianSeries<TItem>.CategoryProperty
CartesianSeries<TItem>.Visible
CartesianSeries<TItem>.ShowInLegend
CartesianSeries<TItem>.ValueProperty
CartesianSeries<TItem>.RenderingOrder
CartesianSeries<TItem>.Markers
CartesianSeries<TItem>.MarkerType
CartesianSeries<TItem>.MarkerSize
RadzenChartComponentBase.ShouldRefreshChart
RadzenChartComponentBase.ValidateParameters
RadzenChartComponentBase.DidParameterChange
RadzenChartComponentBase.Chart
ComponentBase.OnInitialized
ComponentBase.OnInitializedAsync
ComponentBase.OnParametersSet
ComponentBase.OnParametersSetAsync
ComponentBase.StateHasChanged
ComponentBase.ShouldRender
ComponentBase.OnAfterRender
ComponentBase.OnAfterRenderAsync
ComponentBase.InvokeAsync
ComponentBase.DispatchExceptionAsync
ComponentBase.RendererInfo
ComponentBase.Assets
ComponentBase.AssignedRenderMode
Namespace: Radzen.Blazor
Assembly: Radzen.Blazor.dll
public class RadzenColumnSeries<TItem> : CartesianSeries<TItem>, IComponent, IHandleEvent, IHandleAfterRender, IChartSeries, IChartColumnSeries| Name | Description |
|---|---|
| TItem | The type of data items in the series. Each item represents one column in the chart. |
Basic column series:
<RadzenChart>
<RadzenColumnSeries Data=@revenue CategoryProperty="Quarter" ValueProperty="Amount" Title="Revenue" />
</RadzenChart>
Multiple column series with custom colors:
<RadzenChart>
<RadzenColumnSeries Data=@sales2023 CategoryProperty="Month" ValueProperty="Total" Title="2023" Fill="#4169E1" />
<RadzenColumnSeries Data=@sales2024 CategoryProperty="Month" ValueProperty="Total" Title="2024" Fill="#32CD32" />
</RadzenChart>A chart series that displays data as vertical columns (bars) in a RadzenChart. RadzenColumnSeries is ideal for comparing values across categories or showing trends over time with discrete data points. Renders vertical rectangles where the height represents the data value. Multiple column series in the same chart are displayed side-by-side for each category. Supports fill color/stroke color/width customization with individual column colors via Fills/Strokes, dynamic coloring based on value ranges using FillRange and StrokeRange, optional value labels on top of columns, interactive tooltips showing category/value/series name, and click event handling for drill-down scenarios. Use CategoryProperty to specify the X-axis field and ValueProperty for the column height (Y-axis value).
public RadzenColumnSeries<TItem>()Gets or sets the fill (background) color applied to all columns in the series. Supports any valid CSS color value. If not set, uses the color scheme's default color.
public string Fill { get; set; }
| Type | Description |
|---|---|
| string | Gets or sets the fill (background) color applied to all columns in the series. Supports any valid CSS color value. If not set, uses the color scheme's default color. |
Gets or sets value-based color ranges that dynamically color columns based on their values. Allows conditional coloring (e.g., red for negative values, green for positive). Each range specifies a min/max value and a color to apply to columns within that range.
public IList<SeriesColorRange> FillRange { get; set; }
| Type | Description |
|---|---|
| IList<SeriesColorRange> | Gets or sets value-based color ranges that dynamically color columns based on their values. Allows conditional coloring (e.g., red for negative values, green for positive). Each range specifies a min/max value and a color to apply to columns within that range. |
Gets or sets a collection of fill colors to apply to individual columns in sequence. Each column gets the color at its index position, allowing rainbow or gradient-like effects. Takes precedence over the Fill property.
public IEnumerable<string> Fills { get; set; }
| Type | Description |
|---|---|
| IEnumerable<string> | Gets or sets a collection of fill colors to apply to individual columns in sequence. Each column gets the color at its index position, allowing rainbow or gradient-like effects. Takes precedence over the Fill property. |
Gets or sets the line style for column borders (solid, dashed, dotted). Only applicable if stroke is enabled.
public LineType LineType { get; set; }
| Type | Description |
|---|---|
| LineType | Gets or sets the line style for column borders (solid, dashed, dotted). Only applicable if stroke is enabled. |
Gets or sets the stroke (border) color applied to all columns in the series. If not set, columns render without borders.
public string Stroke { get; set; }
| Type | Description |
|---|---|
| string | Gets or sets the stroke (border) color applied to all columns in the series. If not set, columns render without borders. |
Gets or sets value-based color ranges that dynamically color column borders based on their values. Works similarly to FillRange but affects the stroke color instead of fill.
public IList<SeriesColorRange> StrokeRange { get; set; }
| Type | Description |
|---|---|
| IList<SeriesColorRange> | Gets or sets value-based color ranges that dynamically color column borders based on their values. Works similarly to FillRange but affects the stroke color instead of fill. |
Gets or sets the width of the column border in pixels. Only visible if Stroke or Strokes is specified.
public double StrokeWidth { get; set; }
| Type | Description |
|---|---|
| double | Gets or sets the width of the column border in pixels. Only visible if Stroke or Strokes is specified. |
Gets or sets a collection of stroke colors to apply to individual column borders in sequence. Each column border gets the color at its index position. Takes precedence over the Stroke property.
public IEnumerable<string> Strokes { get; set; }
| Type | Description |
|---|---|
| IEnumerable<string> | Gets or sets a collection of stroke colors to apply to individual column borders in sequence. Each column border gets the color at its index position. Takes precedence over the Stroke property. |
protected override void BuildRenderTree(Rendering.RenderTreeBuilder __builder)
| Type | Name | Description |
|---|---|---|
| Rendering.RenderTreeBuilder | __builder |
public override bool Contains(double x, double y, double tolerance)
| Type | Name | Description |
|---|---|---|
| double | x | |
| double | y | |
| double | tolerance |
| Type | Description |
|---|---|
| bool |
public override ValueTuple<object, Point> DataAt(double x, double y)
| Type | Name | Description |
|---|---|---|
| double | x | |
| double | y |
| Type | Description |
|---|---|
| ValueTuple<object, Point> |
public override IEnumerable<Rendering.ChartDataLabel> GetDataLabels(double offsetX, double offsetY)
| Type | Name | Description |
|---|---|---|
| double | offsetX | |
| double | offsetY |
| Type | Description |
|---|---|
| IEnumerable<Rendering.ChartDataLabel> |
public override RenderFragment Render(ScaleBase categoryScale, ScaleBase valueScale)
| Type | Description |
|---|---|
| RenderFragment |
protected override string TooltipStyle(TItem item)
| Type | Name | Description |
|---|---|---|
| TItem | item |
| Type | Description |
|---|---|
| string |