Skip to main content

PivotGridFieldFilterValues.ValuesExcluded Property

Gets or sets which values are excluded from the current field.

Namespace: DevExpress.XtraPivotGrid

Assembly: DevExpress.PivotGrid.v22.2.Core.dll

NuGet Packages: DevExpress.PivotGrid.Core, DevExpress.Win.Dashboard.Design


public object[] ValuesExcluded { get; set; }

Property Value

Type Description

An array of the values that are excluded from being displayed in the current field.


This property returns an array of the values that are not displayed for the current field by the XtraPivotGrid. To get the filter values use the PivotGridFieldFilterValues.Values property.

If an array of values is assigned to the ValuesExcluded property the current filter criteria will be reset and the XtraPivotGrid will then display all the field values for the current field excluding the values in the specified array. The following occurs in this case:

  1. the PivotGridFieldFilterValues.Values array is cleared
  2. values from the source array are copied to the PivotGridFieldFilterValues.Values array
  3. the PivotGridFieldFilterValues.FilterType property is set to PivotFilterType.Excluded.

If null is assigned the values in the PivotGridFieldFilterValues.Values array will be cleared. The result of the operation is dependant on the value of the PivotGridFieldFilterValues.FilterType property.

The following code snippets (auto-collected from DevExpress Examples) contain references to the ValuesExcluded property.


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.

See Also