Assembly: Microsoft.VisualBasic (in microsoft.visualbasic.dll)
For more detailed information, see the Visual Basic topic Clear Method (Err Object).
Use Clear to explicitly clear the Err object after an error has been handled, such as when you use deferred error handling with On Error Resume Next. The Clear method is called automatically whenever any of the following statements executes:
Any type of Resume statement
Exit Sub, Exit Function, or Exit Property
Any On Error statement
Any Try...Catch...Finally statement
The On Error Resume Next construct may be preferable to On Error GoTo when handling errors generated during access to other objects. Checking Err after each interaction with an object removes ambiguity about which object was accessed by the code: You can be sure which object placed the error code in Err.Number, as well as which object originally generated the error (the object specified in Err.Source).
This example uses the Err object's Clear method to reset the numeric properties of the Err object to zero and its string properties to zero-length strings. Without the call to Clear, the second call to MsgBox would display the same error message.
Windows 98, Windows 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 .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
Other ResourcesClear Method (Err Object)
Err Object (Visual Basic)
Description Property (Err Object)
HelpContext Property (Err Object)
HelpFile Property (Err Object)
LastDllError Property (Err Object)
Number Property (Err Object)
On Error Statement (Visual Basic)
Raise Method (Err Object)
Source Property (Err Object)
How to: Retrieve Information from an Error Object