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

 

<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

必选的属性。

指定是启用或禁用自定义错误，还是仅向远程客户端显示自定义错误。

此属性可以为下列值之一。

 

值	说明
On	指定启用自定义错误。如果未指定 defaultRedirect，用户将看到一般性错误。
Off	指定禁用自定义错误。这允许显示标准的详细错误。
RemoteOnly	指定仅向远程客户端显示自定义错误并且向本地主机显示 ASP.NET 错误。这是默认值。

默认值为 RemoteOnly。

 

<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 信息服务 (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>