Back to Devexpress

DataFilter Class

corelibraries-devexpress-dot-xtracharts-72c1113a.md

latest3.9 KB
Original Source

DataFilter Class

Defines filter conditions for a particular series.

Namespace : DevExpress.XtraCharts

Assembly : DevExpress.XtraCharts.v25.2.dll

NuGet Package : DevExpress.Charts

Declaration

csharp
public class DataFilter :
    ChartElement,
    IDataFilter,
    IObjectValueTypeProvider
vb
Public Class DataFilter
    Inherits ChartElement
    Implements IDataFilter,
               IObjectValueTypeProvider

The following members return DataFilter objects:

Remarks

A collection of DataFilter objects should be set to the SeriesBase.DataFilters property. This property is now obsolete.

If you use the DataFilters property, replace it with the FilterString or FilterCriteria property.

csharp
// To convert the following data filter definitions, use the FilterCriteria property below...
chartControl1.Series[0].DataFilters.Add(new DataFilter("Company", "System.String", DataFilterCondition.Equal, "DevAV North"));
chartControl1.Series[0].DataFilters.Add(new DataFilter("SaleDate", "System.DateTime", DataFilterCondition.Equal, new DateTime(2018, 12, 31)));
chartControl1.Series[0].DataFiltersConjunctionMode = ConjunctionTypes.And;

chartControl1.Series[0].FilterCriteria = new BinaryOperator("Company", "DevAV North", BinaryOperatorType.Equal) &
                                         new BinaryOperator("SaleDate", new DateTime(2018, 12, 31), BinaryOperatorType.Equal);

// or the FilterString property:
chartControl1.Series[0].FilterString = "Company='DevAV North' And SaleDate=#2018-12-31#";
vb
' To convert the following data filter definitions, use the FilterCriteria property below...
chartControl1.Series(0).DataFilters.Add(New DataFilter("Company", "System.String", DataFilterCondition.Equal, "DevAV North"))
chartControl1.Series(0).DataFilters.Add(New DataFilter("SaleDate", "System.DateTime", DataFilterCondition.Equal, New DateTime(2018, 12, 31)))
chartControl1.Series(0).DataFiltersConjunctionMode = ConjunctionTypes.[And]

chartControl1.Series(0).FilterCriteria = New BinaryOperator("Company", "DevAV North", BinaryOperatorType.Equal) And New BinaryOperator("SaleDate", New DateTime(2018, 12, 31), BinaryOperatorType.Equal)

' or the FilterString property:
chartControl1.Series(0).FilterString = "Company='DevAV North' And SaleDate=#2018-12-31#"

If you specify the DataFilters property in design mode, it will be automatically converted to the SeriesBase.FilterString property when you upgrade your project to the latest version.

See the following help topic for more information: Filter Series Data.

Inheritance

Object ChartElement DataFilter XRDataFilter

See Also

DataFilter Members

Filter Series Data

DevExpress.XtraCharts Namespace