DxChartRangeBarSeries<T, TArgument, TValue> Class

Defines a range bar series.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v24.1.dll

NuGet Package: DevExpress.Blazor

Declaration

public class DxChartRangeBarSeries<T, TArgument, TValue> :
    DxChartRangeSeriesBase<T, TArgument, TValue>

Type Parameters

Name	Description
T	The type of data.
TArgument	The type of arguments.
TValue	The type of values.

Remarks

Range Bar series display value ranges that correspond to argument values. The Chart selects the maximum and minimum bar limits from data points with an equal argument to specify start and end values.

Use the chart’s Data property to specify an IEnumerable<T> data source, and the ArgumentField and ValueField properties to specify data source fields that contain arguments and values for chart points.

Razor

@inject WeatherForecastService ForecastService

<DxChart Data="@ChartData">
    <DxChartRangeBarSeries ValueField="@((WeatherForecast i) => i.TemperatureF)" 
                           ArgumentField="@(i => i.Date.Date)" 
                           Name="Temperature, F" />
    <DxChartTooltip>
        @context.GetRangePoint().Render((rangePoint) =>
            @<div class="p-3">
                <p>Max: @rangePoint.EndValue</p>
                <p>Min: @rangePoint.StartValue</p>
            </div>
         )
    </DxChartTooltip>
</DxChart>

@code {
    WeatherForecast[] ChartData;

    protected override async Task OnInitializedAsync() {
        ChartData = await ForecastService.GetRangeForecastAsync();
    }
}

WeatherForecast

using System;

public class WeatherForecast {
    public DateTime Date { get; set; }
    public int TemperatureC { get; set; }
    public double TemperatureF => Math.Round((TemperatureC * 1.8 + 32), 2);
    public double Precipitation { get; set; }
}

WeatherForecastService

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;

public class WeatherForecastService {
    private List<WeatherForecast> RangeForecast { get; set; }
    // ...

    public WeatherForecastService() {
        RangeForecast = CreateRangeForecast();
        // ...
    }

    private List<WeatherForecast> CreateRangeForecast() {
        var rng = new Random();
        DateTime startDate = DateTime.Now.Date;
        return Enumerable.Range(1, 15).SelectMany(day => {
            var dayDate = startDate.AddDays(day);
            int avgTemp = rng.Next(-20, 55);
            int minTemp = Math.Max(-20, avgTemp - 10);
            int maxTemp = Math.Min(55, avgTemp + 10);
            return Enumerable.Range(0, 24).Select(hour => new WeatherForecast {
                Date = dayDate.AddHours(hour),
                TemperatureC = rng.Next(minTemp, maxTemp),
                Precipitation = rng.Next(0, 50)
            });
        }).ToList();
    }

    public Task<WeatherForecast[]> GetRangeForecastAsync(CancellationToken ct = default) {
        return Task.FromResult(RangeForecast.ToArray());
    }
    // ...
}

Program.cs

// ...
builder.Services.AddSingleton<WeatherForecastService>();

Run Demo: Charts - Range Bar Series

Implements

IComponent

IHandleEvent

IHandleAfterRender

IDisposable

IChartSeries

IChartSeriesBase

Inheritance

Object

ComponentBase

DxSettingsComponent<DevExpress.Blazor.Internal.IXYChartSeriesModel>

DxComplexSettingsComponent<DxChartSeries, DevExpress.Blazor.Internal.IXYChartSeriesModel>

DxChartSeries

DxChartXYSeries<T, TArgument, TValue, TValue>

DxChartRangeSeriesBase<T, TArgument, TValue>

DxChartRangeBarSeries<T, TArgument, TValue>