ADO Filter Property
❮ Complete Recordset Object Reference
The Filter property sets or returns a variant that contains a filter for the data in a Recordset object. The filter allows you to select records that fit a specific criteria.
The Filter property can contain one of the following:
- A criteria string
- An array of bookmarks
- A FilterGroupEnum value
Examples of a criteria string:
- rs.Filter="Lastname='Smith'"
- rs.Filter="Lastname='Smith' AND Birthdate >= #4/10/70#"
- rs.Filter="Lastname='Jonson' OR Lastname='Johnson'"
- rs.Filter= "Lastname LIKE 'Jon*'"
- rs.Filter="[Company Name]='Alfred Futterkiste' OR Orders>$300.00"
Example of an array of bookmarks:
dim fname(10)
fname(2)=rs.Bookmark
rs.Filter=fname(2)
When the Filter property is set, the cursor moves to the first record in the filtered Recordset. And, when the Filter property is cleared, the cursor moves to the first record in the unfiltered Recordset.
Syntax
objRecordset.Filter
FilterGroupEnum Values
| Constant | Value | Description |
|---|---|---|
| adFilterNone | 0 | Removes the current filter |
| adFilterPendingRecords | 1 | Filter that displays only edited records that have not yet been sent to the server |
| adFilterAffectedRecords | 2 | Filter that displays only records affected by the last Delete, Resync, UpdateBatch, or CancelBatch call |
| adFilterFetchedRecords | 3 | Filter that displays the records in the current cache |
| adFilterConflictingRecords | 5 | Filter that displays those records that failed the last batch update |
❮ Complete Recordset Object Reference
