Método DoCmd.FindRecord (Access)
O método FindRecord executa a ação FindRecord no Visual Basic.
Sintaxe
expressão. FindRecord (FindWhat, Match, MatchCase, Search, SearchAsFormatted, OnlyCurrentField, FindFirst)
expression Uma variável que representa um objeto DoCmd.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| Findwhat | Obrigatório | Variant | Uma expressão avaliada como texto, um número ou uma data. A expressão contém os dados para pesquisar. |
| Match | Opcional | AcFindMatch | Uma constante AcFindMatch que especifica onde pesquisar a correspondência. O valor padrão é acEntire. |
| MatchCase | Opcional | Variantes | Use True para uma pesquisa que diferencia maiúsculas de minúsculas e False para uma pesquisa que não diferencia maiúsculas de minúsculas. Se você deixar esse argumento em branco, o padrão (False) é assumido. |
| Pesquisa | Opcional | AcSearchDirection | Uma constante AcSearchDirection que especifica a direção a ser pesquisada. O valor padrão é acSearchAll. |
| SearchAsFormatted | Opcional | Variantes | Use True para procurar os dados como eles estão formatados e False para procurar os dados como eles estão armazenados no banco de dados. Se você deixar esse argumento em branco, o padrão (False) é assumido. |
| OnlyCurrentField | Opcional | AcFindField | Uma constante AcFindField que especifica se deve pesquisar todos os campos ou apenas o campo atual. O valor padrão é acCurrent. |
| FindFirst | Opcional | Variantes | Use True para iniciar a pesquisa no primeiro registro. Use False para iniciar a pesquisa no registro após o registro atual. Se você deixar esse argumento em branco, o padrão (True) será suposto. |
Comentários
Quando um procedimento chama o método FindRecord , o Access pesquisa os dados especificados nos registros (a ordem da pesquisa é determinada pela configuração do argumento Pesquisar ). Quando o Access localiza os dados especificados, eles são selecionados no registro.
O método FindRecord não retorna um valor que indica o êxito ou falha. Para determinar se existe um valor em um conjunto de registros, use o método FindFirst, FindNext, FindPrevious ou FindLast do objeto Recordset . Esses métodos definem o valor da propriedade NoMatch como True se o valor especificado não for encontrado.
Exemplo
O exemplo a seguir localiza a primeira ocorrência dos registros do nome Smith no campo atual. Ele não encontra ocorrências de smith ou de Smithson.
DoCmd.FindRecord "Smith",, True,, True
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.