Propriedade do filtro ADO
❮ Referência Completa do Objeto do Conjunto de Registros
A propriedade Filter define ou retorna uma variante que contém um filtro para os dados em um objeto Recordset. O filtro permite selecionar registros que atendem a um critério específico.
A propriedade Filter pode conter um dos seguintes:
- Uma string de critérios
- Uma variedade de marcadores
- Um valor FilterGroupEnum
Exemplos de uma string de critérios:
- rs.Filter="Sobrenome='Smith'"
- rs.Filter="Sobrenome='Smith' E Data de Nascimento >= #4/10/70#"
- rs.Filter="Lastname='Jonson' OU Lastname='Johnson'"
- rs.Filter= "Sobrenome LIKE 'Jon*'"
- rs.Filter="[Nome da empresa]='Alfred Futterkiste' OU Pedidos>$300,00"
Exemplo de uma matriz de marcadores:
dim fname(10)
fname(2)=rs.Bookmark
rs.Filter=fname(2)
Quando a propriedade Filter é definida, o cursor se move para o primeiro registro no Recordset filtrado. E, quando a propriedade Filter é desmarcada, o cursor se move para o primeiro registro no Recordset não filtrado.
Sintaxe
objRecordset.Filter
Valores FilterGroupEnum
| 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 |
❮ Referência Completa do Objeto do Conjunto de Registros