Upgrade your Internet Experience
Microsoft.com
Welcome Sign in
.NET Framework Developer Center
Click to Rate and Give Feedback

  Switch on low bandwidth view
This page is specific to
Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:
.NET Framework General Reference
customErrors Element (ASP.NET Settings Schema)

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

<configuration> Element
  system.web Element (ASP.NET Settings Schema)
    <customErrors>
<customErrors defaultRedirect="url"
              mode="On|Off|RemoteOnly">
     <error. . ./>
</customErrors>

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

Attributes

Attribute

Description

defaultRedirect

Optional attribute.

Specifies the default URL to direct a browser to, if an error occurs. When this attribute is not specified, a generic error is displayed instead.

The URL can be absolute (for example, www.contoso.com/ErrorPage.htm) or relative. A relative URL, such as /ErrorPage.htm, is relative to the Web.config file that specified the URL for this attribute, not to the Web page in which the error occurred. A URL starting with a tilde (~), such as ~/ErrorPage.htm, indicates that the specified URL is relative to the root path of the application.

mode

Required attribute.

Specifies whether custom errors are enabled, disabled, or shown only to remote clients.

This attribute can be one of the following values.

Value Description
On Specifies that custom errors are enabled. If no defaultRedirect attribute is specified, users see a generic error. The custom errors are shown to the remote clients and to the local host.
Off Specifies that custom errors are disabled. The detailed ASP.NET errors are shown to the remote clients and to the local host.
RemoteOnly Specifies that custom errors are shown only to the remote clients, and that ASP.NET errors are shown to the local host. This is the default value.

The default is RemoteOnly.

Child Elements

Element

Description

error

Optional element.

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

The error tag can appear multiple times. Each appearance defines one custom error condition.

Parent Elements

Element

Description

configuration

Specifies the 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 settings in a configuration file and contains configuration elements that configure ASP.NET Web applications and control how the applications behave.

The <customErrors> element does not apply to errors that occur in XML Web services.

Default Configuration

The following default customErrors element is configured in the Machine.config file in the .NET Framework versions 1.0 and 1.1. 

<customErrors mode="RemoteOnly" />

The following configuration example demonstrates how to specify the error handling pages to use for an ASP.NET application. 

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

Configuration section handler

CustomErrorsSection

Configuration member

SystemWebSectionGroupCustomErrors()()()

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 Content   What is Community Content?
Add new content RSS  Annotations
"defaultRedirect      bradie ... errors   |   Edit   |   Show History
<!-- Web.Config Configuration File -->

<configuration>
<system.web>
<customErrors mode="Off"/>
</system.web>
</configuration>
Notes: The current error page you are seeing can be replaced by a custom error page by modifying the "defaultRedirect" attribute of the application's <customErrors> configuration tag to point to a custom error page URL.





<!-- Web.Config Configuration File -->

<configuration>
<system.web>
<customErrors mode="RemoteOnly" defaultRedirect="mycustompage.htm"/>
</system.web>
</configuration>
in asp.net 3.5 sp1 there is a new parameter redirectMode      Softlion   |   Edit   |   Show History
<customErrors mode="RemoteOnly" defaultRedirect="/errors/GenericError.aspx" redirectMode="ResponseRewrite">
<error statusCode="404" redirect="/errors/NotFound.aspx"/>
</customErrors>

Tags What's this?: Add a tag
Flag as ContentBug
To clarify redirectMode="ResponseRewrite" behaviour      blueraccoon ... Thomas Lee   |   Edit   |   Show History
To clarify redirectMode="ResponseRewrite" prevents the 302 redirect being issued allowing the error handling page to implement normal functionality. i.e. catching the exception, generally an HttpException and setting the Http status code accordingly.
contact      ying ying ... SLURRY   |   Edit   |   Show History
<!-- Web.Config Configuration File -->

<configuration>
<system.web>
<customErrors mode="off"/>
</system.web>
</configuration>
Notes: The current error page you are seeing can be replaced by a custom error page by modifying the "defaultRedirect" attribute of the application's <customErrors> configuration tag to point to a custom error page URL.





<!-- Web.Config Configuration File -->

<configuration>
<system.web>
<customErrors mode="off"/>
</system.web>
</configuration>
changeing      bryantlatourelle   |   Edit   |   Show History 
  
<!-- Web.Config Configuration File -->

<configuration>
    <system.web>
        <customErrors mode="Off"/>
    </system.web>
</configuration>

© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker