ASPError Object

You can use the ASPError object to obtain information about an error condition that has occurred in script in an ASP page. The ASPError object is returned by the Server.GetLastError method. The ASPError object exposes read-only properties.

Syntax

ASPError.property

Properties

Remarks

When IIS encounters an error either with compiling or running an .asp file, it will generate a 500;100 custom error. By default, all Web sites and applications will transfer processing of a 500;100 custom error to the default .asp file. After a 500;100 custom error is generated, IIS will also create an instance of the ASPError object that describes the error condition.

Example

The following example, extracted from the file 500-100.asp, demonstrates writing the information exposed by the ASPError object.

<%

  Response.Write objASPError.Category

  If objASPError.ASPCode > "" Then Response.Write ", " & objASPError.ASPCode

  Response.Write " (0x" & Hex(objASPError.Number) & ")" & "<br>"



  Response.Write "<b>" & objASPError.Description & "</b><br>"



  If objASPError.ASPDescription > "" Then Response.Write objASPError.ASPDescription & "<br>"



  blnErrorWritten =index.html False



  ' Only show the Source if it is available and the request is from the same machine as IIS

  If objASPError.Source > "" Then

    strServername = LCase(Request.ServerVariables("SERVER_NAME"))

    strServerIP = Request.ServerVariables("LOCAL_ADDR")

    strRemoteIP =  Request.ServerVariables("REMOTE_ADDR")

    If (strServername = "localhost" Or strServerIP = strRemoteIP) And objASPError.File <> "?" Then

      Response.Write objASPError.File 

      If objASPError.Line > 0 Then Response.Write ", line " & objASPError.Line

      If objASPError.Column > 0 Then Response.Write ", column " & objASPError.Column

      Response.Write "<br>"

      Response.Write "<font style="index.html"COLOR:000000; FONT: 8pt/11pt courier new""><b>"

      Response.Write Server.HTMLEncode(objASPError.Source) & "<br>"

      If objASPError.Column > 0 Then Response.Write String((objASPError.Column - 1), "-") & "^<br>"

      Response.Write "</b></font>"

      blnErrorWritten = True

    End If

  End If



  If Not blnErrorWritten And objASPError.File <> "?" Then

    Response.Write "<b>" & objASPError.File

    If objASPError.Line > 0 Then Response.Write ", line " & objASPError.Line

    If objASPError.Column > 0 Then Response.Write ", column " & objASPError.Column

    Response.Write "</b><br>"

  End If

%>

See Also

• Server.GetLastError

Requirements

Platforms: Windows 2000 with IIS 5.0 installed, Windows XP with IIS 5.1 installed, Windows Server 2003 family with IIS 6.0 installed

Platform SDK Release: February 2003

What did you think of this topic?

Order a Platform SDK CD

  .