Error Statement


Updated: July 20, 2015

For the latest documentation on Visual Studio 2017 RC, see Visual Studio 2017 RC Documentation.

Simulates the occurrence of an error.

Error errornumber  

Required. Can be any valid error number.

The Error statement is supported for backward compatibility. In new code, especially when creating objects, use the Err object's Raise method to generate run-time errors.

If errornumber is defined, the Error statement calls the error handler after the properties of the Err object are assigned the following default values:

NumberValue specified as argument to Error statement. Can be any valid error number.
SourceName of the current Visual Basic project.
DescriptionString expression corresponding to the return value of the Error function for the specified Number, if this string exists. If the string does not exist, Description contains a zero-length string ("").
HelpFileThe fully qualified drive, path, and file name of the appropriate Visual Basic Help file.
HelpContextThe appropriate Visual Basic Help file context ID for the error corresponding to the Number property.

If no error handler exists, or if none is enabled, an error message is created and displayed from the Err object properties.

System_CAPS_ICON_note.jpg Note

Some Visual Basic host applications cannot create objects. See your host application's documentation to determine whether it can create classes and objects.

This example uses the Error statement to generate error number 11.

On Error Resume Next   ' Defer error handling.  
Error 11   ' Simulate the "Division by zero" error.  

Namespace: Microsoft.VisualBasic

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

On Error Statement
Resume Statement
Error Messages