VirtualServerModeSource.GetUniqueValues Event

Allows you to provide values for columns’ filter dropdowns.

Namespace: DevExpress.Data

Assembly: DevExpress.Data.v24.1.dll

NuGet Package: DevExpress.Data

Declaration

C#

public event EventHandler<VirtualServerModeGetUniqueValuesEventArgs> GetUniqueValues

VB.NET

Public Event GetUniqueValues As EventHandler(Of VirtualServerModeGetUniqueValuesEventArgs)

Event Data

The GetUniqueValues event's data class is VirtualServerModeGetUniqueValuesEventArgs. The following properties provide information specific to this event:

Property	Description
CancellationToken	Gets a token that allows you to respond to a task cancellation request invoked by the grid control.
FilterExpression	Gets the filter expression applied to the grid.
MaxCount	Gets the maximum number of filter values to return.
UniqueValuesTask	Gets or sets the task that returns requested values.
ValuesExpression	Gets or sets the expression that identifies the currently processed column. This can be a field name or an expression (for calculated columns).
ValuesPropertyName	Gets the currently processed column name (field name), provided that this name can be unambiguously identified.

Remarks

If this event is not handled, the bound grid control obtains filter items itself by iterating through loaded records.

Tip

A Task typically executes asynchronously. To return filter values synchronously, create the task with the Task.FromResult method (available in .NET Framework 4.5+).