Compartilhar via


Bloco de dados ForEachRecord

Aplica-se ao: Access 2013, Office 2013

Um bloco de dados ForEachRecord repete um conjunto de instruções para cada registro em um domínio.

Observação

O bloco de dados ParaCadaRegistro está disponível somente em Macros de Dados.

Setting

A ação ParaCadaRegistro tem os seguintes argumentos.

Argumento

Obrigatório

Descrição

Em

Sim

Uma cadeia de caracteres que identifica o domínio de registros a ser utilizado. O argumento In pode conter o nome da tabela, uma consulta selecionada ou uma instrução SQL.

OBSERVAÇÃO: O domínio especificado não pode incluir dados armazenados em uma tabela vinculada ou fonte de dados ODBC.

Condição Where

Não

Uma expressão de cadeia de caracteres usada para restringir o intervalo de dados no qual o bloco de dados ForEachRecord é executado. Por exemplo, os critérios geralmente são equivalentes à cláusula WHERE em uma expressão SQL, sem a palavra WHERE. Se os critérios forem omitidos, o bloco de dados ForEachRecord funcionará em todo o domínio especificado pelo argumento In . Qualquer campo incluído nos critérios também deve ser um campo em Em.

Alias

Não

Uma cadeia de caracteres que fornece um nome alternativo para o domínio especificado pelo argumento In . Geralmente usado para encurtar o nome da tabela para referências subsequentes para evitar possíveis referências ambíguas. Se Alias não for especificado, o nome da tabela ou da consulta será usado como alias.

Comentários

Use a ação SairparaCadaRegistro para encerrar um bloco de dados ParaCadaRegistro imediatamente.