SeriesTemplate.SeriesDataMember Property

Gets or sets the name of the data member whose values identify series.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v18.2.dll

Declaration

C#

[XtraChartsLocalizableCategory(XtraChartsCategory.Data)]
[XtraSerializableProperty(XtraSerializationVisibility.Visible)]
public string SeriesDataMember { get; set; }

VB.NET

<XtraChartsLocalizableCategory(XtraChartsCategory.Data)>
<XtraSerializableProperty(XtraSerializationVisibility.Visible)>
Public Property SeriesDataMember As String

Property Value

Type	Description
String	The name of the data member whose values identify series.

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 SeriesDataMember 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#

winforms-charts-manage-crosshair-cursor-visibility-in-printed-chart/CS/PrintCrosshairSample/Form1.cs#L27

var template = chartControl.SeriesTemplate;
template.SeriesDataMember = "Company";
template.SetDataMembers("Category", "Value");

webchartcontrol-how-to-change-auto-created-series-appearance/CS/BoundDataChangedExample/WebForm1.aspx.cs#L16

webChartControl.DataSource = seriesData;
webChartControl.SeriesTemplate.SeriesDataMember = "Year";
webChartControl.SeriesTemplate.ArgumentDataMember = "Region";

VB.NET

winforms-charts-manage-crosshair-cursor-visibility-in-printed-chart/VB/PrintCrosshairSample/Form1.vb#L30

Dim template = chartControl.SeriesTemplate
template.SeriesDataMember = "Company"
template.SetDataMembers("Category", "Value")

webchartcontrol-how-to-change-auto-created-series-appearance/VB/BoundDataChangedExample/WebForm1.aspx.vb#L21

webChartControl.DataSource = seriesData
webChartControl.SeriesTemplate.SeriesDataMember = "Year"
webChartControl.SeriesTemplate.ArgumentDataMember = "Region"