DataItem.UniqueId Property
Gets or sets the unique data item identifier.
Namespace: DevExpress.DashboardCommon
Assembly: DevExpress.Dashboard.v20.2.Core.dll
Declaration
Property Value
Type | Description |
---|---|
String | A String that specifies the data item identifier. |
Remarks
The UniqueId property returns null for the newly created data item. If you add the created DataItem to a data-bound dashboard item (DataDashboardItem), the UniqueId will return an auto-generated identifier (DataIem0, DataItem1, etc.), which is unique inside a dashboard item.
You can use the value returned by the UniqueId property to identify the data item in the following cases:
- to refer to the specified data item in filter criteria, pass its identifier to the DataDashboardItem.FilterString property;
- to refer to the specified data item in the Expression format condition, pass its identifier to the FormatConditionExpression.Expression property.
IMPORTANT
If you specified a custom data item identifier, make sure that its value is unique inside a dashboard item. Otherwise, DuplicateDataItemIdException will be thrown.