Você pode usar a ação de macro OnError no Access para especificar o que deve acontecer quando ocorrer um erro em uma macro.
Observação: A ação de macro OnError não está disponível em aplicativos Web do Access.
Configuração
A ação de macro OnError tem os seguintes argumentos.
Argumento da ação |
Descrição |
||||||||
Acesse |
Especifique o comportamento geral que deve ocorrer quando um erro for encontrado. Clique na seta para baixo e clique em uma das seguintes configurações:
|
||||||||
Nome da macro |
Se o argumento Ir para estiver definido como Nome da Macro,digite o nome do submacro a ser usado para tratamento de erros. O nome que você digitar deve corresponder a um nome de submacro na macro atual; você não pode inserir o nome de um objeto de macro diferente. No exemplo abaixo, a sub macro ErrorHandler está contida no mesmo objeto de macro que a ação de macro OnError. Esse argumento deve ser deixado em branco se o argumento Ir para estiver definido como Next ou Fail. |
Comentários
-
A ação de macro OnError geralmente é colocada no início de uma macro, mas você também pode colocar a ação posteriormente na macro. As regras estabelecidas pela ação terão efeito sempre que a ação for executado.
-
Se você definir o argumento Ir paraFalhar,o Access se comportará da mesma maneira que faria se não houvesse nenhuma ação OnError na macro. Ou seja, se um erro for encontrado, o Access interrompe a macro e exibe uma mensagem de erro padrão. O principal uso para a configuração Fail é desativar qualquer tratamento de erro que você estabeleceu anteriormente em uma macro.
Exemplo
A macro a seguir demonstra o uso da ação de macro OnError. Neste exemplo, a ação AoOcorrerErro especifica que o Access deve executar uma submacro de tratamento de erros personalizada chamada ErrorHandler quando ocorre um erro. Se ocorrer um erro em qualquer uma das ações a seguir, o Access irá para a submacro ErrorHandler. A submacro ErrorHandler exibe uma caixa de mensagem que se refere ao objeto MacroError para exibir informações sobre o erro.
Nome do submacro |
Ação |
Argumentos |
OnError |
Vá para: Nome da macro Nome da macro: ErrorHandler |
|
[Ação 2] |
||
... |
||
[Ação n] |
||
ErrorHandler |
MessageBox |
Mensagem: ="Erro # " & [MacroError]. [Número] & " on " & [MacroError]. [ActionName] & " action". Beep: Sim Tipo: Nenhum Título: Erro ocorrido |
Aqui está uma captura de tela do designer de macros do Access (Access versão 2010 e posterior) com o exemplo anterior. Nesse caso, a expressão na ação DefinirVarLocal dispara um erro porque está tentando dividir um número por zero. O Access se move para baixo até a submacro chamada ErrorHandler e exibe as informações de erro em uma caixa de mensagem.