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>