Método Find (ADO)

Procura um Recordset na linha que atende aos critérios especificados. Opcionalmente, a direção da pesquisa, a linha inicial e o deslocamento da linha inicial podem ser especificados. Se os critérios forem atendidos, a posição da linha atual será definida no registro encontrado; caso contrário, a posição é definida como o final (ou início) do Recordset.

Sintaxe

  
Find (Criteria, SkipRows, SearchDirection, Start)  

Parâmetros

Critérios
Um valor String que contém uma instrução que especifica o nome da coluna, o operador de comparação e o valor a ser usado na pesquisa.

SkipRows
Opcional. Um valor Long, cujo valor padrão é zero, que especifica o deslocamento de linha da linha atual ou o indicador Start para iniciar a pesquisa. Por padrão, a pesquisa será iniciada na linha atual.

SearchDirection
Opcional. Um valor SearchDirectionEnum que especifica se a pesquisa deve começar na linha atual ou na próxima linha disponível na direção da pesquisa. Uma pesquisa malsucedida será interrompida no final do Recordset se o valor for adSearchForward. Uma pesquisa malsucedida será interrompida no início do Recordset se o valor for adSearchBackward.

Iniciar
Opcional. Um indicador Variant que funciona como a posição inicial da pesquisa.

Comentários

Somente um nome de coluna única pode ser especificado em criteria. Esse método não dá suporte a pesquisas de várias colunas.

O operador de comparação em Criteria pode ser ">" (maior que), "<" (menor que), "=" (igual), ">=" (maior ou igual), "<=" (menor ou igual), "<>" (não igual) ou "like" (correspondência de padrões).

O valor em Criteria pode ser uma cadeia de caracteres, um número de ponto flutuante ou uma data. Os valores de cadeia de caracteres são delimitados com aspas simples ou marcas "#" (tecla jogo da velha) (por exemplo, "state = 'WA"" ou "state = #WA#"). Os valores de data são delimitados com marcas "#" (tecla jogo da velha) (por exemplo, "start_date > #22/7/97#"). Esses valores podem conter horas, minutos e segundos para indicar carimbos de data/hora, mas não devem conter milissegundos; do contrário, erros ocorrerão.

Se o operador de comparação for "like", o valor da cadeia de caracteres poderá conter um asterisco (*) para localizar uma ou mais ocorrências de um caractere ou substring. Por exemplo, "state like 'M*'" corresponde a Maine e Massachusetts. Você também pode usar asteriscos à esquerda e à direita para encontrar uma subcadeia de caracteres contida nos valores. Por exemplo, "state like '*as*'" corresponde ao Alasca, Arkansas e Massachusetts.

Os asteriscos só podem ser usados no final de uma cadeia de caracteres de critérios ou no início e no final de uma cadeia de caracteres de critérios, conforme mostrado acima. Você não pode usar o asterisco como um curinga à esquerda ('*str') ou como um curinga inserido ('s*r'). Isso causará um erro.

Observação

Ocorrerá um erro se uma posição de linha atual não estiver definida antes de chamar Find. Qualquer método que define a posição da linha, como MoveFirst, deve ser chamado antes de chamar Find.

Observação

Se você chamar o método Find em um conjunto de registros e a posição atual no conjunto de registros estiver no último registro ou no final do arquivo (EOF), você não encontrará nada. Você precisa chamar o método MoveFirst para definir a posição/o cursor atual no início do conjunto de registros.

Aplica-se A

Objeto Recordset (ADO)

Consulte Também

Exemplo do método Find (VB)
Propriedade Index
Otimizar a propriedade dinâmica (ADO)
Método Seek