customErrors 元素（ASP.NET 设置架构）
更新：2007 年 11 月
为 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 |
必选的属性。 指定是启用或禁用自定义错误，还是仅向远程客户端显示自定义错误。 此属性可以为下列值之一。
默认值为 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>
元素信息
配置节处理程序 |
|
配置成员 |
|
可配置的位置 |
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 |
请参见
任务
概念
参考
customErrors 的 error 元素（ASP.NET 设置架构）