HttpErrorElement 类
配置对特定 HTTP 错误的响应。
语法
class HttpErrorElement : CollectionElement
方法
此类不包含任何方法。
属性
下表列出了 HttpErrorElement 类公开的属性。
| 名称 | 描述 |
|---|---|
Path |
一个必需的读/写 string 值，包含响应中提供的文件名和 URL，此响应用于 StatusCode 和 SubStatusCode 属性指定的 HTTP 错误。 |
PrefixLanguageFilePath |
一个可选的读/写 string 值，指定自定义错误页目录的物理路径。 自定义错误页目录包含一个或多个特定于语言的子目录，其中包含 StatusCode 属性中指定的错误的自定义错误页。文件路径构造如下：PrefixLanguageFilePath\ClientLanguageID\CustomErrorPageFile。 例如，PrefixLanguageFilePath 可能是“%SystemDrive%\inetpub\custerr”，ClientLanguageID 可能是“en-us”，CustomErrorPageFile（由 Path 属性指定）可能是“401.htm”。 注意：自定义错误是特定于语言的，通常以客户端的系统语言返回自定义错误。 若要以不同于客户端系统语言的语言返回错误页，必须在客户端上安装该语言的语言包。 例如，如果 PrefixLanguageFilePath 为“d:\inetpub\custerr”，并且客户端安装了 en-US 语言包，则当客户端浏览器在 Accept-Language 标头中发送“en-us”时，错误代码 404 的结果路径为 d:\inetpub\custerr\en-us\404.htm。 但是，如果系统语言为 ja-JP，并且未安装 en-US 语言包，则生成的路径为 d:\inetpub\custerr\ja-jp\404.htm。 |
ResponseMode |
一个必需的读/写 sint32 值，指定对由 StatusCode 和 SubStatusCode指定的 HTTP 错误的响应。 后文的“注解”部分列出了可能的值。 |
StatusCode |
一个必需唯一读/写 uint32 值，包含状态代码从 400 到 999。 一个键属性。 |
SubStatusCode |
一个必需唯一读/写 sint32 值，包含从 –1 到 999 的子状态代码。 默认值为 -1。 一个键属性。 |
子类
此类不包含子类。
注解
此类的实例包含在 HttpErrorsSection 类的 HttpErrors 数组属性中。
此类表示 ApplicationHost.config 文件的 <httpErrors> 节中的 <error> 元素。
下表列出了 ResponseMode 属性的可能值和关键字。 默认值为 0 (File)。
| 值 | 关键字 | 说明 |
|---|---|---|
| 0 | File |
Web 服务器返回属性 Path 中指定的网页。 |
| 1 | ExecuteURL |
Web 服务器返回在 Path 中指定的 ASP 页。 |
| 2 | Redirect |
Web 服务器将请求重定向到 Path 中指定的 URL。 |
继承层次结构
HttpErrorElement
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - IIS 7.0（在 Windows Vista 上） - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10 上的 IIS 10.0 |
| 服务器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016 上的 IIS 10.0 |
| 产品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF 文件 | WebAdministration.mof |