Propriedade Form.OnError (Access)

Define ou retorna o valor da caixa Erro ativado no janela Propriedades de um formulário ou relatório. String de leitura/gravação.

Sintaxe

expressão. Onerror

expressão Uma variável que representa um objeto Form.

Comentários

Essa propriedade é útil para alterar programaticamente a ação que o Microsoft Access toma quando um evento é disparado. Por exemplo, você pode alterar os parâmetros de uma expressão entre as chamadas de eventos ou alternar entre um procedimento de evento e uma expressão ou uma macro, dependendo das circunstâncias nas quais o evento foi disparado.

O evento Error ocorre quando um erro em tempo de execução é produzido no Microsoft Access quando um formulário ou relatório tem o foco. Isso inclui erros do mecanismo de banco de dados Microsoft Jet, mas erros em tempo de execução não no Visual Basic.

O valor OnError será um dos seguintes, dependendo da seleção escolhida na janela Escolher Construtor (acessada escolhendo o botão Compilar ao lado da caixa De Erro no janela Propriedades do objeto):

• Se você escolher Construtor de Expressões, o valor será =expression, em que a expressão é a expressão da janela Construtor de Expressões.

• Se você escolher Construtor de Macros, o valor será o nome da macro.

• Se você escolher Construtor de Código, o valor será [Procedimento de Evento].

Se a caixa Em Erro estiver em branco, o valor da propriedade será uma cadeia de caracteres vazia.

Exemplo

O exemplo a seguir associa o evento Error ao Error_Handler_Macro de macro para o formulário de Entrada de Pedido .

Forms("Order Entry").OnError = "Error_Handler_Macro"

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.