Ação de macro ProcurarRegistro

Você pode usar a ação de macro SearchForRecord nos bancos de dados da área de trabalho do Access para pesquisar um registro específico em uma tabela, consulta, formulário ou relatório.

Configuração

A ação de macro SearchForRecord tem os seguintes argumentos.

Argumento da ação

Descrição

Tipo de Objeto

Insira ou selecione o tipo de objeto de banco de dados no qual você está pesquisando. Você pode selecionar Tabela,Consulta,Formulárioou Relatório.

Nome do Objeto

Insira ou selecione o objeto específico que contém o registro a ser pesquisado. A lista lista listada mostra todos os objetos de banco de dados do tipo selecionado para o argumento Tipo de Objeto.

Gravar

Especifique o ponto inicial e a direção da pesquisa.

Configuração

Descrição

Anterior

Pesquise para trás do registro atual.

Avançar

Pesquise para frente do registro atual.

Primeiro

Pesquise para frente do primeiro registro. Esse é o valor padrão para esse argumento.

Sobrenome

Pesquisa para trás do último registro.

Condição Where

Insira os critérios da pesquisa usando a mesma sintaxe SQL cláusula WHERE, somente sem a palavra "WHERE". Por exemplo,

Description = "Beverages"

Para criar um critério que inclua um valor de uma caixa de texto em um formulário, você deve criar uma expressão que concatene a primeira parte do critério com o nome da caixa de texto contendo o valor para o qual pesquisar. Por exemplo, o critério a seguir pesquisará no campo Descrição o valor na caixa de texto chamada txtDescription no formulário chamado frmCategories. Observe o sinal de igual (=) no início da expressão e o uso de aspas simples (') em cada lado da referência da caixa de texto:

="Description = '" & Forms![frmCategories]![txtDescription] & "'"

Comentários

  • Nos casos em que mais de um registro corresponde aos critérios no argumento Where Condition, os seguintes fatores determinam qual registro é encontrado:

    • A configuração do argumento Record    Consulte a tabela na seção Configurações para obter mais informações sobre o argumento Record.

    • A ordem de classificação dos registros    Por exemplo, se o argumento Record for definido como First, alterar a ordem de classificação dos registros poderá alterar o registro encontrado.

  • O objeto especificado no argumento Nome do Objeto deve estar aberto antes que essa ação seja executado. Caso contrário, ocorrerá um erro.

  • Se os critérios no argumento Where Condition não são atendidos, nenhum erro ocorre e o foco permanece no registro atual.

  • Ao pesquisar o registro anterior ou próximo, a pesquisa não "quebra" quando atinge o final dos dados. Se não houver registros adicionais que corresponderem aos critérios, nenhum erro ocorrerá e o foco permanecerá no registro atual. Para confirmar se uma combinação foi encontrada, você pode inserir uma condição para a próxima ação e tornar a condição igual aos critérios no argumento Where Condition.

  • Para executar a ação SearchForRecord em um módulo VBA, use o método SearchForRecorddo objeto DoCmd.

  • A ação de macro SearchForRecord é semelhante à ação de macro FindRecord, mas SearchForRecord tem recursos de pesquisa mais avançados. A ação de macro FindRecord é usada principalmente para localizar cadeias de caracteres e duplica a funcionalidade da caixa de diálogo Localizar. A ação de macro SearchForRecord usa critérios mais parecidos com os de um filtro ou SQL consulta. A lista a seguir demonstra algumas coisas que você pode fazer com a ação de macro SearchForRecord:

    • Você pode usar critérios complexos no argumento Where Condition, como

Descrição = "Bebidas" e CategoryID = 11

  • Você pode se referir a campos que estão na fonte de registro de um formulário ou relatório, mas não são exibidos no formulário ou no relatório. No exemplo anterior, nem Description nem CategoryID devem ser exibidos no formulário ou relatório para que os critérios funcionem.

  • Você pode usar operadores lógicos, como <, >, AND, ORe BETWEEN. A ação FindRecord corresponde apenas a cadeias de caracteres que são iguais, começam com ou contêm a cadeia de caracteres que está sendo pesquisada.

Exemplo

A macro a seguir abre primeiro a tabela Categorias usando a ação OpenTable. Em seguida, a macro usa a ação de macro SearchForRecord para encontrar o primeiro registro na tabela em que o campo Descrição é igual a "Bebidas".

Ação

Argumentos

OpenTable

Nome da tabela: Categorias

Exibir: Folha de Dados

Modo de Dados: Editar

SearchForRecord

Tipo de objeto: Tabela

Nome do objeto: Categorias

Registro: Primeiro

Condição where: Description = "Beverages"

Precisa de mais ajuda?

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×