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

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

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

<customErrors defaultRedirect="url"
              mode="On|Off|RemoteOnly">
     <error. . ./>
</customErrors>

属性和元素

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

属性

属性 说明

defaultRedirect

可选的属性。

指定出错时将浏览器定向到的默认 URL。如果未指定该属性,则显示一般性错误。

URL 可以是绝对的(如 www.contoso.com/ErrorPage.htm)或相对的。相对 URL(如 /ErrorPage.htm)是相对于为该属性指定 URL 的 Web.config 文件,而不是相对于发生错误的网页。以颚化符 (~) 开头的 URL(如 ~/ErrorPage.htm)表示指定的 URL 是相对于应用程序的根路径。

mode

必选的属性。

指定是启用或禁用自定义错误,还是仅向远程客户端显示自定义错误。

此属性可以为下列值之一。

说明

On

指定启用自定义错误。如果未指定 defaultRedirect,用户将看到一般性错误。

Off

指定禁用自定义错误。这允许显示标准的详细错误。

RemoteOnly

指定仅向远程客户端显示自定义错误并且向本地主机显示 ASP.NET 错误。这是默认值。

默认值为 RemoteOnly

子元素

元素 说明

error

可选的元素。

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

错误标记可以出现多次。子标记的每一次出现均定义一个自定义错误条件。

父元素

元素 说明

configuration

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

system.web

指定配置文件中 ASP.NET 配置设置的根元素,并且包含各种配置元素,这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。

备注

<customErrors> 元素不适用于 XML Web services 中发生的错误。

默认配置

下面的默认 customErrors 元素是在 .NET Framework 1.0 和 1.1 版的 Machine.config 文件中配置的。

<customErrors mode="RemoteOnly" />

示例

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

<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.SystemWebSectionGroup.CustomErrors

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 配置设置

参考

system.web 元素(ASP.NET 设置架构)
configuration 元素(常规设置架构)
customErrors 的 error 元素(ASP.NET 设置架构)
System.Configuration
System.Web.Configuration

概念

ASP.NET 配置概述
ASP.NET Web 服务器控件和浏览器功能
保证 ASP.NET 配置的安全
ASP.NET 配置方案

其他资源

ASP.NET 配置文件
ASP.NET 配置设置
常规配置设置 (ASP.NET)
ASP.NET 配置 API