Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O método FindRecord realiza a ação LocalizarRegisto 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 |
|---|---|---|---|
| LocalizarO que | 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 procurar a correspondência. O valor padrão é acEntire. |
| MatchCase | Opcional | Variant | 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 procurar. O valor padrão é acSearchAll. |
| SearchAsFormatted | Opcional | Variant | 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 pretende procurar todos os campos ou apenas o campo atual. O valor padrão é acCurrent. |
| FindFirst | Opcional | Variant | 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 procura os dados especificados nos registos (a ordem da pesquisa é determinada pela definição do argumento Procurar ). 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 num conjunto de registos, utilize o método FindFirst, FindNext, FindPrevious ou FindLast do objeto Conjunto de registos . Estes métodos definem o valor da propriedade NoMatch como Verdadeiro 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.