Web.config 之customErrors标记

本文介绍如何使用Web.config文件中的<customErrors>元素来配置ASP.NET应用程序的自定义错误页面。通过设置mode属性可以控制是否显示详细的错误信息,通过defaultRedirect属性可以指定错误页的默认跳转URL。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

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>

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值