DataItem.DataMember Property

Gets or sets the identifier of a corresponding data member in the data source.

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v19.1.Core.dll

Declaration

C#

[DefaultValue(null)]
public string DataMember { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Property DataMember As String

Property Value

Type	Default	Description
String	*null*	A String that specifies a data member that corresponds to this data item.

Remarks

To specify the data member identifier, pass it to the constructor of a DataItem descendant when creating its instance.

The data member identifier consists of the data table name and the column name, dot separated. For instance, the Street Address column from the Customers table is identified as “Customers.Street Address”.

If a data source has been specified in code, particular data fields can be custom objects. In this instance, the identifier is a chain of property names, like “Customers.City.Population”.

Note that aliases specified in the Query Builder are not used in data member identifiers; actual column names are used instead.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DataMember 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-dashboard-modify-item-runtime/CS/DashboardItemRuntimeExample/ViewerForm1.cs#L36

ChartDashboardItem chart = (ChartDashboardItem)item;
foreach (var dimension in chart.GetDimensions().Where(d => d.DataMember == "Category"))
    dimension.DataMember = "State";

VB.NET

winforms-dashboard-modify-item-runtime/VB/DashboardItemRuntimeExample/ViewerForm1.vb#L33

Dim chart As ChartDashboardItem = CType(item, ChartDashboardItem)
For Each dimension In chart.GetDimensions().Where(Function(d) d.DataMember = "Category")
    dimension.DataMember = "State"