Export (0) Print
Expand All

error Element for customErrors (ASP.NET Settings Schema) 

Specifies the custom error page for a given HTTP status code.


<error statusCode="statuscode"
       redirect="url"/>

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description

statusCode

Required attribute.

Specifies the HTTP status code that results in redirection to the error page.

redirect

Required attribute.

The URL of the custom page that is mapped to the error code.

Child Elements

None.

Parent Elements

Element Description

configuration

Specifies the required root element in every configuration file that is used by the common language runtime and the .NET Framework applications.

system.web

Specifies the root element for the ASP.NET configuration section.

customErrors

Provides information about custom error messages for an ASP.NET application. It can be defined at any level in the application file hierarchy.

The following configuration code example specifies the error handling pages to use for an ASP.NET application.

The custom errors are only issued for the elements that are handled by ASP.NET. For example, if you refer to a non-existing .htm page, Microsoft Internet Information Services (IIS) issues the standard 404 error. If you refer instead to a non-existing .aspx page, ASP.NET issues the custom 404 error, if you configured the error.

<configuration>
  <system.web>
    <customErrors defaultRedirect="GenericError.htm"
                  mode="RemoteOnly">
       <error statusCode="500"
              redirect="InternalError.htm"/>
    </customErrors>
  </system.web>
</configuration>

Configuration section handler

System.Web.Configuration.CustomErrorsSection

Configuration member

System.Web.Configuration.CustomErrorsMode

Configurable locations

Machine.config

Root-level Web.config

Application-level Web.config

Virtual or physical directory–level Web.config

Requirements

Microsoft Internet Information Services (IIS) version 5.0, 5.1, or 6.0

The .NET Framework version 1.0, 1.1, or 2.0

Microsoft Visual Studio 2003 or Visual Studio 2005

Community Additions

ADD
Show:
© 2014 Microsoft