首页 > 代码库 > Asp.net Web.Config - 配置元素customErrors
Asp.net Web.Config - 配置元素customErrors
Asp.net配置文件的配置方式，其实在MSDN里面是写得最清楚的了。可惜之前一直未曾了解到MSDN的强大。
先贴个地址：http://msdn.microsoft.com/zh-cn/library/dayb112d(v=vs.80).aspx，然后逐个分析。我希望自己能够从头到尾认真学完这系列东西。为了不至于让自己太早放弃，我决定从自己用过的配置文件学起，然后逐渐接触那些比较生疏，和少用的。
一、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。 |
2、位置
customerErrors -> configuration-> system.web //该元素放于<system.web>下的<configuration>节点下
3、子元素
| 元素 | 说明 |
|---|---|
error | 指定给定 HTTP 状态代码的自定义错误页。 可选的元素。 错误标记可以出现多次。子标记的每一次出现均定义一个自定义错误条件。 |
4、配置示例：
<configuration> <system.web> <customErrors defaultRedirect="defaultError.htm" //发生错误时，重定向到defaultError.htm mode="RemoteOnly"> //仅仅对本地用户显示详细错误信息 <error statusCode="500" //针对500错误，跳转到500Error.htm redirect="500Error.htm"/> </customErrors> </system.web></configuration>
5、配置节处理程序
该配置节点对应Asp.net中的配置节类为：
System.Web.Configuration.CustomErrorsSection
来看看在类的主要公共属性：
| 属性 | 说明 |
| DefaultRedirect | 获取或设置重定向的默认 URL。 |
| ElementInformation | 获取包含 ConfigurationElement 对象的不可自定义的信息和功能的 ElementInformation 对象。 （从 ConfigurationElement 继承。） |
| Errors | 获取 CustomError 对象的集合，也就是其下面的<error>配置节。 |
| LockAllAttributesExcept | 获取被锁定的属性的集合。 （从 ConfigurationElement 继承。） |
| LockAllElementsExcept | 获取被锁定的元素的集合。 （从 ConfigurationElement 继承。） |
| LockAttributes | 获取被锁定的属性的集合。 （从 ConfigurationElement 继承。） |
| LockElements | 获取被锁定的元素的集合。 （从 ConfigurationElement 继承。） |
| LockItem | 获取或设置一个值，该值指示是否已锁定该元素。 （从 ConfigurationElement 继承。） |
| Mode | 获取或设置错误显示模式。 |
| SectionInformation | 获取一个 SectionInformation 对象，该对象包含 ConfigurationSection 对象的不可自定义的信息和功能。 （从 ConfigurationSection 继承。） |
下面以程序示例如何在程序中读取和设置配置节：
public ActionResult Index() { //<customErrors defaultRedirect="defaultError.htm" mode="Off"> // <error statusCode="500" redirect="500.htm"/> //</customErrors> //CustomErrorsSection customErrorsSection = ConfigurationManager.GetSection("system.web/customErrors") as CustomErrorsSection; //这样获取也可以，但是要注意里面的路径的写法 CustomErrorsSection CES = (CustomErrorsSection)WebConfigurationManager.OpenWebConfiguration("/").GetSection("system.web/customErrors"); Response.Write(CES.DefaultRedirect); //输出 defaultError.htm CustomErrorsMode mode = CES.Mode; Response.Write(mode); //输出 Off CustomError CE = CES.Errors[0]; //获取其下的第一个子<error>节点 Response.Write(CE.StatusCode); //输出 500 Response.Write(CE.Redirect); //输出 500.htm ElementInformation EleInfo = CES.ElementInformation; //元素信息 Response.Write(EleInfo.LineNumber); //输出 14 恰好是customErrors所在Web.Config的行号 System.Configuration.Configuration c = CES.CurrentConfiguration; //当前Configuration对象的引用 Response.Write(CES.IsReadOnly()); //输出 False 指示该节点是否为只读 Response.Write(CES.LockItem); //输出 False 是否已锁定该元素 Response.Write(CES.RedirectMode); //输出 ResponseRedirect 一个枚举 将用户重定向到自定义错误页面时，是否应该更改请求的URL SectionInformation SI = CES.SectionInformation; Response.Write(SI.Name); //输出 customErrors return View(); }