Ação de macro LimparErroDeMacro

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Você pode usar a ação de Limparerrodemacro para limpar as informações sobre um erro que está armazenado no objeto MacroError .

Observação : A ação de macro Limparerrodemacro não está disponível no Access web apps.

Configuração

A ação Limparerrodemacro não tem argumentos.

Comentários

  • Quando ocorre um erro em uma macro, informações sobre o erro são armazenadas no objeto MacroError . Se você não tiver usado o ação AoOcorrerErro suprimir mensagens de erro, as paradas de macro e as informações de erro é exibida em uma mensagem de erro padrão. No entanto, se você tiver usado a ação AoOcorrerErro suprimir mensagens de erro, talvez você queira usar as informações armazenadas no objeto MacroError em uma condição ou em uma mensagem de erro personalizada.

    Após um erro tem sido tratado, as informações no objeto MacroError estão desatualizadas, portanto, é uma boa ideia para limpar o objeto usando a ação de Limparerrodemacro . Isso redefine o número do erro do objeto MacroError como 0 e limpa quaisquer outras informações sobre o erro que está armazenado no objeto, como a descrição de erro, nome da macro, nome da ação, condição e argumentos. Dessa forma, você pode inspecionar o objeto MacroError novamente mais tarde para ver se outro erro ocorreu.

  • O objeto MacroError é automaticamente desmarcado quando qualquer macro termina, então você não precisa usar a ação Limparerrodemacro no final de uma macro.

  • O objeto MacroError contém informações sobre um único erro de cada vez. Se mais de um erro ocorreu em uma macro, o objeto MacroError contém informações apenas sobre o último erro.

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

Exemplo

A macro a seguir usa a ação AoOcorrerErro com o próximo argumento para eliminar mensagens de erro e, em seguida, usa a ação AbrirFormulário para abrir um formulário. Neste exemplo, um erro deliberadamente é criado usando a ação IrParaRegistro para ir para o registro anterior. A condição [MacroError]. [Número] <> 0 testa o objeto MacroError . Se ocorreu um erro, o número do erro for diferente de zero e executa a ação CaixaDeMensagem . A caixa de mensagem exibe o nome da ação que causou o erro (nesse caso, a ação IrParaRegistro ) e o número do erro é exibido. Por fim, a execução da ação Limparerrodemacro limpa o objeto MacroError .

Condição

Ação

Argumentos

AoOcorrerErro

Vá para: próximo

AbrirFormulário

Nome do formulário: CategoryForm

Modo de exibição: formulário

Modo janela: Normal

IrParaRegistro

Tipo de objeto: formulário

Nome do objeto: CategoryForm

Registro: anterior

[MacroError]. [Número] <> 0

MsgBox

Mensagem: = "erro #" & [MacroError]. [Número] & "em" & [MacroError]. [Nome da ação] & "ação".

AlarmeSonoro: Sim

Tipo: informações

Limparerrodemacro

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
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.

×