customErrors 的 error 元素(ASP.NET 设置架构)
[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
指定给定 HTTP 状态代码的自定义错误页。
<error statusCode="statuscode"
redirect="url"/>
特性和元素
以下几节描述了特性、子元素和父元素。
特性
特性 |
说明 |
---|---|
statusCode |
必需的特性。 指定导致重定向到错误页的 HTTP 状态代码。 |
redirect |
必需的特性。 映射到错误代码的自定义页的 URL。 |
子元素
无。
父元素
元素 |
说明 |
---|---|
configuration |
指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
为 ASP.NET 配置节指定根元素。 |
customErrors |
为 ASP.NET 应用程序提供有关自定义错误消息的信息。 可以在应用程序文件层次结构中的任意级别上定义此信息。 |
示例
下面的配置代码示例指定用于 ASP.NET 应用程序的错误处理页。
将只为由 ASP.NET 处理的元素发出自定义错误。 例如,如果引用不存在的 .htm 页,则 Microsoft Internet Information Services (IIS) 将发出标准的 404 错误。 但是,如果引用不存在的 .aspx 页,则 ASP.NET 将发出自定义的 404 错误(如果配置了该错误)。
<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 |
请参见
任务
How to: Lock ASP.NET Configuration Settings
参考
概念
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities