DataFilter.DataType Property

Gets or sets the data type of the value associated with the current data filter object.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.1.dll

Declaration

public Type DataType { get; set; }
Public Property DataType As Type

Property Value

Type Description
Type

A Type object that represents the value data type.

Remarks

Use the DataType property to specify the data type of the filter value represented by the current data filter item. This value is specified by the DataFilter.Value property.

Note that setting the DataType property value is critical for assigning the correct filter value of a data filter item. The data type defined by this property should coincide with the data type of the data field specified by the DataFilter.ColumnName property. And the value assigned to the DataFilter.Value property can only be of the specified data type.

Examples

The following example demonstrates how to create DataFilter objects, and apply their conditions to a series at runtime. For more information, refer to Filtering Data.

For this example to work correctly, a chart should contain at least one series, which is bound to the "Categories" data table in the Northwind Traders database (nwind.mdb file shipped with the XtraCharts demo). Please refer to the following tutorial to see how to bind a series to data: How to: Bind Individual Chart Series to Data (Runtime Sample).

The code below creates and applies the following filter to series data: "CategoryID = 1 or CategoryID = 4 or CategoryID = 7"

using DevExpress.XtraCharts;
// ...

// Create new data filters and specify conditions for them.
DataFilter dataFilter1 = new DataFilter("CategoryID", "System.Int32", DataFilterCondition.Equal, 1);
DataFilter dataFilter2 = new DataFilter("CategoryID", "System.Int32", DataFilterCondition.Equal, 4);
DataFilter dataFilter3 = new DataFilter("CategoryID", "System.Int32", DataFilterCondition.Equal, 7);

// Obtain the first series of the chart.
Series series1 = chartControl1.Series[0];

// Set the logical operator used to combine individual data filter conditions for this series.
series1.DataFiltersConjunctionMode = ConjunctionTypes.Or;

// Remove all other filters.
series1.DataFilters.Clear();

// Add new filters to apply to the series data.
series1.DataFilters.AddRange(new DataFilter[] {dataFilter1, dataFilter2, dataFilter3});

Implements

DevExpress.Charts.Native.IDataFilter.DataType
DevExpress.XtraCharts.Design.IObjectValueTypeProvider.DataType
See Also