A newer version of this page is available.

PivotGridFieldBase.GetAvailableValuesAsync(AsyncCompletedHandler) Method

Returns a list of field values that are not excluded by filters applied to other fields and can be displayed. Performs this operation asynchronously.

Namespace: DevExpress.XtraPivotGrid

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


public void GetAvailableValuesAsync(
    AsyncCompletedHandler asyncCompleted


Name Type Description
asyncCompleted AsyncCompletedHandler

A AsyncCompletedHandler delegate referencing a method that should be executed after the operation is completed.


The GetAvailableValuesAsync method is asynchronous. It starts executing the related operation in a background thread, and immediately returns control. The primary UI thread is not blocked, allowing the application to continue responding to end-user actions. For more information about the asynchronous mode, see Asynchronous Mode.

A list of available field values (an array of Object) is passed to the asyncCompleted delegate via the result parameter. This parameter returns an AsyncOperationResult instance. Use the AsyncOperationResult.Value property to obtain the list of field values.

Assume that a pivot grid contains two dimension fields: Category Name and Product Name.


If there is no filtering applied to the Category Name field, the GetAvailableValuesAsync method called for the Product Name field will return all unique field values, since all of them can be displayed.

If the Category Name field has a filter that allows displaying only the Beverages category, the GetAvailableValuesAsync method called for the Product Name field will return only products related to the Beverages category, since all other products are excluded by the category filtering.

To obtain a list of available field values synchronously, use the PivotGridFieldBase.GetAvailableValues method.

PivotGridControl also allows you to remove field values that cannot be displayed from filter drop-down lists. To do this, use the PivotGridOptionsFilterBase.ShowOnlyAvailableItems property for XtraPivotGrid, and the PivotGridWebOptionsFilter.ShowOnlyAvailableItems property for ASPxPivotGrid.


If the PivotGridControl filters data by OLAP member unique names (controlled by the PivotGridFieldOptions.OLAPFilterByUniqueName and PivotGridOptionsOLAP.FilterByUniqueName options), the GetAvailableValuesAsync method returns them instead of field values.

See Also