MDAC 2.5 SDK - ADO


 

FilterCriterion Property (RDS)

See Also    Example    Applies To

Indicates the evaluation operator to use in the filter value.

Syntax

DataControl.FilterCriterion = String

Parameters

DataControl   An object variable that represents an RDS.DataControl object.

String   A String value that specifies the evaluation operator of the FilterValue to the records. Can be any one of the following: <, <=, >, >=, =, or <>.

Remarks

The SortColumn, SortDirection, FilterValue, FilterCriterion, and FilterColumn properties provide sorting and filtering functionality on the client-side cache. The sorting functionality orders records by values from one column. The filtering functionality displays a subset of records based on find criteria, while the full Recordset is maintained in the cache. The Reset method will execute the criteria and replace the current Recordset with an updatable Recordset.

The "!=" operator is not valid for FilterCriterion; instead, use "<>".

If both the filter and sort properties are set and you call the Reset method, the rowset is first filtered and then it is sorted. For ascending sorts, the null values are at the top; for descending sorts, null values are at the bottom (ascending is default behavior).