XRChart.SeriesDataMember Property
Gets or sets the name of the data field whose values are used to automatically generate and populate series.
Namespace: DevExpress.XtraReports.UI
Assembly: DevExpress.XtraReports.v24.2.dll
NuGet Package: DevExpress.Reporting.Core
Declaration
Property Value
| Type | Description |
|---|---|
| String | A String value that specifies the data field’s name. |
Remarks
When chart binding is used to automatically generate series within a chart control based upon the data obtained from the associated data source (XRChart.DataSource), a rule needs to be defined that helps the chart control recognize the data records whose values are used to construct individual series objects. To do this, the SeriesDataMember property can be used. It specifies the data field whose values are taken into account when series objects are automatically created and populated.
Each automatically generated series gets its name from the data field specified by the SeriesDataMember property. This name is used to identify a series within the chart control’s legend, for example. The names of all automatically generated series can be supplemented with the same prefix and postfix defined by the settings which are available via the XRChart.SeriesNameTemplate property.
The template settings for the dynamically created series are defined by the specific properties which are available via the XRChart.SeriesTemplate property of a chart control. In particular, the SeriesBase.ArgumentDataMember and SeriesBase.ValueDataMembers properties specify the data fields from which the arguments and data values of the series data points are obtained.
Note that if the SeriesDataMember property is not set for a chart control, the chart control can’t automatically generate series even if the SeriesBase.ArgumentDataMember and SeriesBase.ValueDataMembers properties are defined.