ChartControl.SeriesTemplate Property

Returns the series template the chart uses to generate its series.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v21.2.UI.dll

NuGet Packages: DevExpress.Win.Charts, DevExpress.Win.Design

Declaration

C#

public SeriesTemplate SeriesTemplate { get; }

VB.NET

Public ReadOnly Property SeriesTemplate As SeriesTemplate

Property Value

Type	Description
SeriesTemplate	The series template the chart uses to generate its series.

Remarks

Refer to the Generate Series from a Data Source topic for more information about design time template configuration.

Example

The following code demonstrates how to automatically generate series and fill them with data from a data source. It uses the classes and properties below:

Symbol	Description
ChartControl.SeriesTemplate	Returns the series template the chart uses to generate its series.
SeriesTemplate	The series template that the chart uses to generate its series.
SeriesTemplate.SeriesDataMember	Gets or sets the name of the data member whose values identify series.
SeriesBase.ArgumentDataMember	Gets or sets the name of the data field that contains series point arguments.
SeriesBase.ValueDataMembers	Gets a collection of the names of data fields that contain series point values.

C#

class GdpInfo {
    public int Year { get; set; }
    public String Region { get; set; }
    public double Value { get; set; }
}

// ...
// Note that the GetGdpDataSource method is not a part of the Chart Control API.
// This method provides a data object list that the Chart should display.
List<GdpInfo>  gdpDataSource = GetGdpDataSource();
chartControl.DataSource = gdpDataSource;
chartControl.SeriesTemplate.SeriesDataMember = "Year";
chartControl.SeriesTemplate.ArgumentDataMember = "Region";
chartControl.SeriesTemplate.ValueDataMembers.AddRange("Value");
// ...

VB.NET

Class GdpInfo
    Public Property Year As Integer
    Public Property Region As String 
    Public Property Value As Double
End Class

' ...
' Note that the GetGdpDataSource method is not a part of the Chart Control API.
' This method provides a data object list that the Chart should display.
Dim gdpDataSource As List(Of GdpInfo) = GetGdpDataSource()
chartControl.DataSource = gdpDataSource;
chartControl.SeriesTemplate.SeriesDataMember = "Year";
chartControl.SeriesTemplate.ArgumentDataMember = "Region";
chartControl.SeriesTemplate.ValueDataMembers.AddRange("Value");
' ...

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the SeriesTemplate 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-sort-stacked-bars-by-total-values-using-qualitativescalecomparer-t585190/CS/Form1.cs#L16

chartControl1.SeriesDataMember = "Series";
SeriesTemplate seriesTemplate = chartControl1.SeriesTemplate;
seriesTemplate.ArgumentDataMember = "Argument";

winforms-charts-configure-settings-for-template-series-and-series-added-manually/CS/series-base-example/Form1.cs#L22

chart.SeriesTemplate.View = new LineSeriesView();
ConfigureSeries(chart.SeriesTemplate);

VB.NET

how-to-sort-stacked-bars-by-total-values-using-qualitativescalecomparer-t585190/VB/Form1.vb#L18

chartControl1.SeriesDataMember = "Series"
Dim seriesTemplate As SeriesTemplate = chartControl1.SeriesTemplate
seriesTemplate.ArgumentDataMember = "Argument"

winforms-charts-configure-settings-for-template-series-and-series-added-manually/VB/series-base-example/Form1.vb#L24

chart.SeriesTemplate.View = New LineSeriesView()
ConfigureSeries(chart.SeriesTemplate)