Método Find (ADO)

Aplica-se ao: Access 2013, Office 2013

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

Sintaxe

Localizar (Critérios, SkipRows, SearchDirection, Iniciar)

Parâmetros

Parâmetro	Descrição
Criteria	Um valor String que contém uma instrução que especifica o nome da coluna, o operador da comparação e o valor a ser utilizado na pesquisa.
SkipRows	Opcional. Um valor Long, cujo valor padrão é zero, que especifica o deslocamento de linha a partir da linha atual ou do indicador Start para iniciar a pesquisa. Por padrão, a pesquisa iniciará na linha atual.
SearchDirection	Opcional. Um valor SearchDirectionEnum que especifica que a pesquisa deve iniciar na linha atual ou na próxima linha disponível na direção da pesquisa. Uma pesquisa sem êxito para no final do Recordset se o valor for adSearchForward. Uma pesquisa sem êxito para no início do Recordset se o valor for adSearchBackward.
Start	Opcional. Um indicador Variant que funciona como a posição inicial da pesquisa.

Comentários

Apenas um único nome de coluna pode ser especificado em criteria. Este método não suporta 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 sequência, um número de ponto flutuante ou uma data. Valores de sequência são delimitados por aspas únicas ou marcas "#" (sinal numérico), 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#") e podem conter horas, minutos e segundos para indicar carimbos de tempo, mas não devem conter milissegundos ou erros.

Se o operador de comparação for "like", o valor da sequência poderá conter um asterisco (*) para localizar uma ou mais ocorrências de qualquer caractere ou subsequência. Por exemplo, "state like 'M*'" corresponde a Maine e Massachusetts. Você também pode usar asteriscos no início ou final para localizar uma subsequência contida nesses valores. Por exemplo, "state like '*as*'" corresponde a Alaska, Arkansas e Massachusetts.

Os asteriscos podem ser utilizados apenas no final de uma sequência de critérios ou em conjunto, tanto no início quanto no final de uma sequência de critérios, conforme mostrado acima. Não é possível utilizar o asterisco como um caractere curinga inicial ('*str') ou como caractere curinga incorporado ('s*r'). Isso causará um erro.

Observação

[!OBSERVAçãO] Ocorrerá um erro se uma posição de linha atual não for definida antes de chamar Find. Qualquer método que defina posição de linha, tal como MoveFirst, deve ser chamado antes de chamar Find.

Observação

[!OBSERVAçãO] Se você chamar o método Find em um recordset e a posição atual no recordset estiver no último registro ou no final do arquivo (EOF), nada será encontrado. É necessário chamar o método MoveFirst para definir a posição atual/cursor para o início do recordset.