On Error Instruction

Syntax

On Error GoTo 0
-or-
On Error GoTo label
-or-
On Error Resume Next

Group

Error Handling

Description

Form 1: Disable the error handler (default).

Form 2: Send error conditions to an error handler.

Form 3: Error conditions continue execution at the next statement.

On Error sets or disables the error handler. Each user defined procedure has its own error handler. The default is to terminate the macro on any error. The Err object's properties are set whenever an error occurs. Once an error has occurred and the error handler is executing any further errors will terminate the macro, unless the Err object has been cleared.

NOTE: This instruction clears the Err and sets Error`$' to null.

Example

Sub Main
    On Error Resume Next
    Err.Raise 1
    Debug.Print "RESUMING, Err="; Err
    On Error GoTo X
    Err.Raise 1
    Exit Sub
 
X:  Debug.Print "Err="; Err
    Err.Clear
    Debug.Print "Err="; Err
    Resume Next
End Sub