Web.config 之customErrors标记

Web.config 文件中的<customErrors>元素用于提供有关 ASP.NET 应用程序自定义错误消息的信息,结构说明如下:

 

<configuration>

   ... ...

   <system.web>

      ... ...

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

      <error statusCode="statuscode1" redirect="url1"/>

      <error statusCode="statuscode2" redirect="url2"/>

   </system.web>

   ... ...

</customErrors>

 

用途:

通过修改应用程序Web.config文件的 <customErrors> 标记的“defaultRedirect”属性，可以使之指向自定义错误页的URL，用自定义错误页替换所看到的当前错误页。

若要使他人能够在远程计算机上查看此特定错误信息的详细信息，应将此 <customErrors> 标记的“mode”属性设置为“Off”,或者"RemoteOnly".

 

属性/选项 描述

Mode     指定启用、禁用或仅对远程客户端显示自定义错误。

    On     指定启用自定义错误。如果没有指定 defaultRedirect，用户将看到一般性错误。

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

    RemoteOnly 指定仅向远程客户端端显示自定义错误，并向本地主机显示 ASP.NET 错误。(默认值)

 

可选属性 描述

defaultRedirect 指定发生错误时浏览器指向的默认URL。如果没有指定 defaultRedirect，则会显示一般性错误。URL 既可以是绝对路径（例如 http://www.xxxx.com/ErrorPage.htm），也可以是相对路径。相对路径（如/ErrorPage.htm）是相对于指定defaultRedirect 的 Web.config 文件而言的，而不是针对产生错误的网页。以波形符 (~) 开头的 URL（如 ~/ErrorPage.htm）表示所指定的 URL 是相对于应用程序根路径而言的。

 

子标记 描述

<error> 错误子标记可以出现多次。每出现一次便定义了一个自定义错误条件。

 

注 : <customErrors> 元素不适用于在 XML Web 服务中出现的错误。

 

例:

<customErrors Mode="RemoteOnly" defaultRedirect="ErrorPage.htm">
　　 <error statusCode="403" redirect="Forbidden.htm"/>
　　 <error statusCode="404" redirect="NotFound.htm"/>

</customErrors>