DataItem Class

Serves as the base class for data items - measures and dimensions.

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v21.2.Core.dll

Declaration

C#

public abstract class DataItem :
    IDataItemRepositoryProvider,
    ISupportInitialize,
    IEditNameProvider,
    IFormatOwnerContext

VB.NET

Public MustInherit Class DataItem
    Implements IDataItemRepositoryProvider,
               ISupportInitialize,
               IEditNameProvider,
               IFormatOwnerContext

Related API Members

The following members accept/return DataItem objects:

• CardItemFormatRule.DataItem
• CellsItemFormatRule.DataItem
• CellsItemFormatRule.DataItemApplyTo
• ChartItemFormatRuleBase.DataItem
• DataItemPopupMenuShowingEventArgs.DataItem

Remarks

The DataItem class identifies a data binding. A data item is mapped to a particular data source member when creating the instance of the DataItem descendant and can be assigned to a dashboard item. As a result, this binds the dashboard item to the data member.

This class also provides format settings for date-time and numeric values accessed via the DataItem.DateTimeFormat and DataItem.NumericFormat properties.

The DataItem class derives the Measure and Dimension classes for binding to quantitative and non-quantitative data respectively. These classes allow you to enable data shaping and configure summary calculation, depending on the binding type.

DataItem serves as the base class for the following descendants:

• Measure
• Dimension

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DataItem class.

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-apply-conditional-formatting-to-the-card-dashboard-item/CS/CardFormatRulesSample/Form1.cs#L22

}
public void AddCommonRule(CardItemFormatRuleCollection formatRules, DataItem dataItem) {
    // Applies a light-green background color to cards whose actual value is equal to the set condition.

VB.NET

how-to-apply-conditional-formatting-to-the-card-dashboard-item/VB/CardFormatRulesSample/Form1.vb#L24

End Sub
Public Sub AddCommonRule(ByVal formatRules As CardItemFormatRuleCollection, ByVal dataItem As DataItem)
    ' Applies a light-green background color to cards whose actual value is equal to the set condition.

Inheritance

Object

DataItem

Dimension

Measure