customErrors 元素（ASP.NET 设置架构）

1、适用版本：.NET Framework 4

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

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

3、特性和元素

特性	说明
defaultRedirect	可选特性。 指定出错时将浏览器定向到的默认 URL。 如果未指定该特性，则显示一般性错误。 URL 可以是绝对的（如 www.contoso.com/ErrorPage.htm）或相对的。 相对 URL（如 /ErrorPage.htm）是相对于为该特性指定 URL 的 Web.config 文件，而不是相对于发生错误的网页。 以波形符 (~) 开头的 URL（如 ~/ErrorPage.htm）表示指定的 URL 是相对于应用程序的根路径
mode	必选特性。 指定是启用或禁用自定义错误，还是仅向远程客户端显示自定义错误。 此特性可以为下列值之一 On：指定启用自定义错误。如果未指定 defaultRedirect 特性，用户将看到一般性错误。会向远程客户端和本地主机显示自定义错误。 Off：指定禁用自定义错误。会向远程客户端和本地主机显示详细的 ASP.NET 错误。 RemoteOnly：指定仅向远程客户端显示自定义错误并且向本地主机显示 ASP.NET 错误。这是默认值。 默认值为 RemoteOnly。
redirectMode	可选特性。 指定当显示自定义错误页面时，如何处理原始请求的 URL 的值。 此特性可以为下列值之一。 ResponseRedirect：说明直接连接到浏览器的 URL 必须与原来的 Web 请求 URL 不同。 ResponseRewrite：说明直接连接到浏览器的 URL 必须为原来的 Web 请求 URL。

 

父元素

configuration	指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
system.web	指定配置文件中 ASP.NET 配置设置的根元素，并包含用于配置 ASP.NET Web 应用程序和控制应用程序行为方式的配置元素。

 

 

子元素

error

可选元素。 指定给定 HTTP 状态代码的自定义错误页。 错误标记可以出现多次。 子标记的每一次出现均定义一个自定义错误条件。

 

 

 

4、默认配置

下面的默认 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>