Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Information.Err Method

Contains information about run-time errors.

Namespace: Microsoft.VisualBasic
Assembly: Microsoft.VisualBasic (in microsoft.visualbasic.dll)

public static ErrObject Err ()
public static ErrObject Err ()
public static function Err () : ErrObject
Not applicable.

Return Value

Contains information about run-time errors.

For more detailed information, see the Visual Basic topic Err Object (Visual Basic).

The properties of the Err object are set by the generator of an error—Visual Basic, an object, or the programmer.

When a run-time error occurs, the properties of the Err object are filled with information that uniquely identifies the error and that you can use to handle the error. To generate a run-time error in your code, use the Raise method.

The Err object's properties are reset to zero or zero-length strings ("") after an Exit Sub, Exit Function, Exit Property, or Resume Next statement within an error-handling routine. Using any form of the Resume statement outside of an error-handling routine will not reset the Err object's properties. You can use the Clear method to explicitly reset Err.

Use the Raise method rather than the Error statement to generate run-time errors for system errors and class modules. Your decision about whether to use the Raise method in other code depends on the richness of the information you want to return.

The Err object is an intrinsic object with global scope. Therefore, you do not need to create an instance of it in your code.

This example uses the properties of the Err object in constructing an error-message dialog box. Notice that if you use the Clear method first, when you generate a Visual Basic error with the Raise method, Visual Basic's default values become the properties of the Err object.

Dim Msg As String
' If an error occurs, construct an error message.
On Error Resume Next   ' Defer error handling.
Err.Clear()
Err.Raise(6)   ' Generate an "Overflow" error.
' Check for error, then show message.
If Err.Number <> 0 Then
  Msg = "Error # " & Str(Err.Number) & " was generated by " _
      & Err.Source & ControlChars.CrLf & Err.Description
  MsgBox(Msg, MsgBoxStyle.Information, "Error")
End If

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2015 Microsoft