WebChartControl.Series Property

Provides access to the chart control’s collection of series objects.

Namespace: DevExpress.XtraCharts.Web

Assembly: DevExpress.XtraCharts.v18.2.Web.dll

Declaration

C#

public SeriesCollection Series { get; }

VB.NET

Public ReadOnly Property Series As SeriesCollection

Property Value

Type	Description
SeriesCollection	A SeriesCollection object that represents the collection of all series.

Remarks

The Series property provides access to a collection of all series which are defined explicitly within a chart control (either at design time or runtime). The collection is represented by an instance of the SeriesCollection class, and allows individual series (which are instances of the Series class) to be added, deleted and accessed using indexer notation.

Note that series which are bound to data at the level of a web chart control (in particular, using the ASPxDataWebControlBase.DataSource, WebChartControl.SeriesDataMember and both the SeriesBase.ArgumentDataMember and SeriesBase.ValueDataMembers properties) are created dynamically, based upon the data obtained from the specified data source and they are not presented within the Series collection. In order to access such series, use the web chart control’s specific events (such as the WebChartControl.BoundDataChanged event, for instance). To perform a centralized customization of such series, use the settings which are available via the WebChartControl.SeriesTemplate property.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Series property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-preserve-the-legend-checkbox-item-state-when-the-series-items-are-created-manually-t470764/CS/dxSample/Default.aspx.cs#L49

WebChartControl chartControl = (WebChartControl)sender;
foreach (Series series in chartControl.Series)
    SaveSeriesLegendCheckState(series.Name, series.CheckedInLegend);

how-to-register-and-use-a-custom-summary-function-t257661/CS/RegisterSummaryFunctionExample/MainForm.aspx.cs#L51

// Specify the summary function for the series.
Series series = chartControl.Series["Product"];
series.SummaryFunction = BuildSummaryFunction("UnitPrice", "UnitsOnOrder");

webchartcontrol-how-to-create-a-drill-down-chart/CS/DrillDownChart/WebForm1.aspx.cs#L44

if (e.States.Last().Parameters.TryGetValue("ProductCategory", out categoryValue)) {
    int seriesIndex = WebChartControl1.Series.IndexOf(WebChartControl1.Series[(string)categoryValue]);
    int colorIndex = seriesIndex % WebChartControl1.PaletteRepository[WebChartControl1.PaletteName].Count + 1;

VB.NET

how-to-preserve-the-legend-checkbox-item-state-when-the-series-items-are-created-manually-t470764/VB/dxSample/Default.aspx.vb#L52

Dim chartControl As WebChartControl = DirectCast(sender, WebChartControl)
For Each series As Series In chartControl.Series
    SaveSeriesLegendCheckState(series.Name, series.CheckedInLegend)

how-to-register-and-use-a-custom-summary-function-t257661/VB/RegisterSummaryFunctionExample/MainForm.aspx.vb#L40

' Specify the summary function for the series.
Dim series As Series = chartControl.Series("Product")
series.SummaryFunction = BuildSummaryFunction("UnitPrice", "UnitsOnOrder")

webchartcontrol-how-to-create-a-drill-down-chart/VB/DrillDownChart/WebForm1.aspx.vb#L44

If e.States.Last().Parameters.TryGetValue("ProductCategory", categoryValue) Then
    Dim seriesIndex As Integer = WebChartControl1.Series.IndexOf(WebChartControl1.Series(DirectCast(categoryValue, String)))
    Dim colorIndex As Integer = seriesIndex Mod WebChartControl1.PaletteRepository(WebChartControl1.PaletteName).Count + 1