Método Find (ADO)

Pesquisa um conjunto de registros para a linha que atende aos critérios especificados. Opcionalmente, a direção da pesquisa, da linha inicial e do deslocamento da linha inicial pode ser especificada. 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 conjunto de registros .

Sintaxe

  
Find (Criteria, SkipRows, SearchDirection, Start)  

Parâmetros

critérios de
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 iniciar indicador para iniciar a pesquisa. Por padrão, a pesquisa será iniciada na linha atual.

do 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 conjunto de registros se o valor for adSearchForward. Uma pesquisa malsucedida será interrompida no início do conjunto de registros se o valor for adSearchBackward.

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

Observações

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

O operador de comparação em critérios 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 "#" (sinal de número) (por exemplo, "state = 'WA"" ou "state = #WA#"). Os valores de data são delimitados com marcas "#" (sinal de número) (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 ou 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 qualquer caractere ou subcadeia de caracteres. Por exemplo, "estado como 'M*'" corresponde a Maine e Massachusetts. Você também pode usar asteriscos à esquerda e à direita para localizar uma subcadeia de caracteres contida nos valores. Por exemplo, "estado como '*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.

Nota

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

Nota

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

Aplica-se a

do objeto Recordset (ADO)

Consulte Também

de exemplo do método Find (VB)
de propriedade de índice
otimizar Property-Dynamic (ADO)
método Seek