Dimension.SortByMeasure Property

Gets or sets a Measure by which values of this data item should be sorted.

Namespace: DevExpress.DashboardCommon

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

NuGet Package: DevExpress.Dashboard.Core

Declaration

C#

[DefaultValue(null)]
public Measure SortByMeasure { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Property SortByMeasure As Measure

Property Value

Type	Default	Description
Measure	null	A Measure object that specifies a measure by which values of this data item should be sorted.

Remarks

Use the SortByMeasure property to enable sorting by a measure. To do this, assign a measure that should define the sort order to the SortByMeasure property. Use the Dimension.SortOrder property to specify the sort order.

You can only sort by a measure that is either displayed in the same dashboard item or added to its DataDashboardItem.HiddenMeasures collection. Otherwise, if you assign a measure that does not correspond to the current dashboard item, nothing will happen.

Note

Note that when the Top N feature is enabled, dimension values are forcefully sorted by the DimensionTopNOptions.Measure measure, regardless of the SortByMeasure property value.