Bloco de dados ForEachRecord

Aplica-se ao: Access 2013, Office 2013

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

Observação

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

Configuração

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 Em pode conter o nome da tabela, uma consulta selecionar ou uma instrução SQL.

NOTA: o domínio especificado não pode incluir dados armazenados numa tabela ligada ou origem de dados ODBC.

Condição Where

Não

Uma expressão de cadeia utilizada 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 funciona 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 que fornece um nome alternativo para o domínio especificado pelo argumento In . Frequentemente utilizado 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 consulta será utilizado como alias.

Comentários

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