Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Custom Errors Tab, ASP.NET Configuration Settings Dialog Box

When an error occurs in an ASP.NET Web page or component, ASP.NET raises an error code. Errors can include the following types:

  • Compile-time.

  • Parser (malformed ASP.NET elements).

  • Configuration.

  • Run-time.

    NoteNote

    The MMC snap-in for ASP.NET works with IIS 6.0 or earlier. The IIS 7.0 administration tool includes the functionality of the ASP.NET MMC tool. For more information, see ASP.NET and IIS Configuration.

By default, ASP.NET dynamically generates an error page that contains a description of the error, the name of the page on which the error occurred, and a stack trace. If debug mode is enabled, the dynamically generated page also includes an excerpt of the source code where the error originated. By defining custom errors, you can specify how the Web application responds when an error occurs.

NoteNote

For detailed information about debugging mode, see Application Tab, ASP.NET Configuration Settings Dialog Box.

To display the Custom Errors tab of the ASP.NET Configuration Settings dialog box

  1. In Microsoft Windows, open Administrative Tools, and then click Internet Information Services (IIS) Manager.

    IIS Manager appears.

  2. Under Internet Information Services, expand Servername (local computer), expand Web Sites, right-click either Websitename or Default Website, and then click Properties.

    The Web Site Properties dialog box appears.

  3. Click the ASP.NET tab, and then click Edit Configuration.

    The ASP.NET Configuration Settings dialog box appears.

  4. Click the Custom Errors tab.

The Custom Errors tab lets you complete the following tasks:

  • Specify a default error page to display when an ASP.NET error occurs anywhere in the Web application.

  • Map specific HTTP error codes to corresponding error pages.

    NoteNote

    Mappings work only for errors that ASP.NET is notified of. For example, by default, ASP.NET is not notified of HTTP 404 errors (page not found). If you want ASP.NET to receive these errors, you can set the Web site properties to map HTTP errors to .aspx pages.

  • Specify whether custom error pages are displayed for all users, no users, or remote (non-administrative) users.

Custom error mode

Click a mode to specify how custom errors are displayed, as follows:

  • On   

    Custom error pages are always displayed. Use this setting to view errors while you are developing the Web application.

  • Off   

    Custom error pages are not displayed. Instead, errors result in a dynamically generated ASP.NET error page.

  • Remote Only   

    Errors are redirected only for requests that do not originate locally on the Web server. Use this mode to view ASP.NET errors while working on the server, but display custom errors the Web application users.

Default redirect URL

Type the page name (.aspx or .htm) to display in response to unhandled errors anywhere in the Web application.

Inherited custom errors

Lists the custom error pages that are inherited from configuration files that are higher in the hierarchy. You can override the inherited error settings by adding a local custom error for the status code you want to override.

Local custom errors

Lists the error pages for the current Web site, specifically.

Add

Click to open the Edit/Add Custom Error Handlers dialog box where you can specify an HTTP error code and the page to display when ASP.NET detects the error.

NoteNote

Mappings work only for errors that ASP.NET is notified of. For example, by default, ASP.NET is not notified of HTTP 404 errors (page not found). If you want ASP.NET to receive these errors, you can set the Web site properties to map HTTP errors to .aspx pages.

You must provide the HTTP error code and the URL of the page it maps to. The page that you reference does not have to be in the current Web site.

NoteNote

IIS Manager does not validate the URL that you enter.

Edit

Click to open the Edit/Add Custom Error Handlers dialog box where you can change the page name or error code for the page that you selected under Local custom errors.

Remove

Click to delete an error page mapping.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft. All rights reserved.