Compartilhar via


Bloco de dados CreateRecord

Aplica-se ao: Access 2013, Office 2013

Você pode usar o bloco de dados CriarRegistro para criar um novo registro na tabela especificada.

Observação

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

Setting

O bloco de dados ExcluirRegistro tem os seguintes argumentos.

Argumento

Obrigatório

Descrição

Criar Registro em

Sim

O nome da tabela onde o novo registro será criado.

Alias

Não

Uma cadeia de caracteres que identifica o registro. Você pode usar o alias do registro para identificá-lo

Comentários

O registro criado por CriarRegistro se torna automaticamente o registro atual.

Após a instrução CreateRecord , você pode inserir um bloco de comandos que será executado antes que o novo registro seja confirmado. As ações a seguir estão disponíveis em bloco de dados CriarRegistro.

Ação de macro CancelarAlteraçãodeRegistro

Instrução de macro Comentário

Instrução de macro Grupo

Se... Então... Instrução macro Else

Ação de macro DefinirCampo

Ação de macro DefinirVarLocal

Depois que a ação CriarRegistro criar um registro, use a ação DefinirCampo para especificar o valor de um campo no novo registro.

Você pode usar uma instrução Se...Então...Senão para executar operações com base em uma condição.

Para cancelar a criação de um registro, use a ação CancelarAlteraçãodeRegistro. Dessa forma, as alterações não são atribuídas e o bloco de dados CriarRegistro é encerrado.

Quando o novo registro for atribuído, você poderá usar a variável local IdentidadedeRegistroCriadapelaÚltimaVez para executá-la com o registro. Por exemplo, use a sintaxe a seguir para se referir ao campo AssignedTo do registro criado mais recentemente.

[LastCreateRecordIdentity].[AssignedTo]

O bloco de dados CriarRegistro somente pode ser usado nos eventos de macro de dados Após Inserir, Após Atualizar e Após Atualizar.