customErrors 的 error 元素(ASP.NET 设置架构)

更新:2007 年 11 月

指定给定 HTTP 状态代码的自定义错误页。

<configuration> 元素
  system.web 元素(ASP.NET 设置架构)
    customErrors 元素(ASP.NET 设置架构)
      customErrors 的 error 元素(ASP.NET 设置架构)

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

属性和元素

下面几部分描述了属性、子元素和父元素。

属性

属性

说明

statusCode

必选的属性。

指定导致重定向到错误页的 HTTP 状态代码。

redirect

必选的属性。

映射到错误代码的自定义页的 URL。

子元素

无。

父元素

元素

说明

configuration

指定公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。

system.web

为 ASP.NET 配置节指定根元素。

customErrors

为 ASP.NET 应用程序提供有关自定义错误信息的信息。可以在应用程序文件层次结构中的任意级别上定义此信息。

示例

下面的配置代码示例指定用于 ASP.NET 应用程序的错误处理页。

将只为由 ASP.NET 处理的元素发出自定义错误。例如,如果引用不存在的 .htm 页,Microsoft Internet 信息服务 (IIS) 将发出标准的 404 错误。但是,如果引用不存在的 .aspx 页,则 ASP.NET 将发出自定义的 404 错误(如果配置了该错误)。

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

元素信息

配置节处理程序

System.Web.Configuration.CustomErrorsSection

配置成员

System.Web.Configuration.CustomErrorsMode

可配置的位置

Machine.config

根级别的 Web.config

应用程序级别的 Web.config

虚拟或物理目录级别的 Web.config

要求

Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0

.NET Framework 版本 1.0、1.1 或 2.0

Microsoft Visual Studio 2003 或 Visual Studio 2005

请参见

任务

如何:锁定 ASP.NET 配置设置

概念

ASP.NET 配置概述

ASP.NET Web 服务器控件和浏览器功能

保证 ASP.NET 配置的安全

ASP.NET 配置方案

参考

customErrors 元素(ASP.NET 设置架构)

system.web 元素(ASP.NET 设置架构)

configuration 元素(常规设置架构)

System.Configuration

System.Web.Configuration

其他资源

ASP.NET 配置文件

ASP.NET 配置设置

常规配置设置 (ASP.NET)

ASP.NET 配置 API