Propriedade Report. OnError (Access)Report.OnError property (Access)

Define ou retorna o valor da caixa On Error na janela Propriedades de um formulário ou relatório.Sets or returns the value of the On Error box in the Properties window of a form or report. Cadeia de caracteres de leitura/gravação.Read/write String.

SintaxeSyntax

expressão. **** OnErrorexpression.OnError

expressão Uma variável que representa um objeto Report .expression A variable that represents a Report object.

ComentáriosRemarks

Essa propriedade é útil para alterar programaticamente a ação que o Microsoft Access executa quando um evento é disparado.This property is helpful for programmatically changing the action that Microsoft Access takes when an event is triggered. 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.For example, between event calls you may want to change an expression's parameters, or switch from an event procedure to an expression or macro, depending on the circumstances under which the event was triggered.

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.The Error event occurs when a run-time error is produced in Microsoft Access when a form or report has the focus. Isso inclui erros do mecanismo de banco de dados Microsoft Jet, mas erros em tempo de execução não no Visual Basic.This includes Microsoft Jet database engine errors, but not run-time errors in Visual Basic.

O **** valor OnError será um dos seguintes, dependendo da seleção escolhida na janela escolher Construtor (acessada quando você escolher o botão construir ao lado da caixa ao ocorrer erro , na janela Propriedades do objeto):The OnError value will be one of the following, depending on the selection chosen in the Choose Builder window (accessed by choosing the Build button next to the On Error box in the object's Properties window):

  • Se você escolher o construtor de expressões, o valor será =expressão, onde expressão é a expressão da janela do construtor de expressões.If you choose Expression Builder, the value will be =expression, where expression is the expression from the Expression Builder window.

  • Se você escolher Construtor de macros, o valor será o nome da macro.If you choose Macro Builder, the value is the name of the macro.

  • Se você escolher o construtor de código, o valor será [procedimento do evento].If you choose Code Builder, the value will be [Event Procedure].

Se a caixa ao erro estiver em branco, o valor da propriedade será uma sequência de caracteres vazia.If the On Error box is blank, the property value is an empty string.

ExemploExample

O exemplo a seguir associa o evento Error à macro Error_Handler_Macro para o formulário de entrada de pedidos .The following example associates the Error event with the macro Error_Handler_Macro for the Order Entry form.

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

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.