VBScript Object: Err Object

OBJECT: Err

The Err object holds information about the last run-time error that occured. It is not nessecary to create an instance of this object; it is intrinsic to VBScript. It's default property is Number, which contains an integer representing a VBScript error number or an ActiveX control Status Code (SCODE) number. This value is automatically generated when an error occurs and is reset to zero (no error) after an On Error Resume Next statement or after using the Clear method.

The following code checks the value of the Number property and, if it contains a value other than zero, displays the details in the browser.

Code:
<%
dim numerr, abouterr
On Error Resume Next
Err.Raise 6
numerr = Err.number
abouterr = Err.description
If numerr <> 0 Then
Response.Write "An Error has occured! Error number " & numerr & " of_
the type '" & abouterr & "'."
End If
%>

Output:
"An Error has occured! Error number 6 of the type 'Overflow'."

PROPERTIES

Description Property
This property returns or sets a string containing a brief textual description of an error.

Syntax: object.Description [ = string]

HelpContext Property
This property is used to set or return a context ID for a Help topic specified with the HelpFile property.

Syntax: object.HelpContext [ = contextID]

HelpFile Property
This property is used to get or define the path to a Help file.

Syntax: object.HelpFile [ = contextID]

Number Property
This property is used to retrieve or set the value that relates to a specific run-time error.

Syntax: object.Number [ = errnumber]

Source Property
This property lets us determine the object or application that caused an error, and returns a string that contains it's Class name or programmatic ID.

Syntax: object.Source [ = string]

METHODS

Clear Method
This method is used to clear the settings of the Error object.

Syntax: object.Clear

Raise Method
This method is used to generate a VBScript run-time error.

Syntax: object.Raise(number[, source, description, helpfile, helpcontext])