HttpErrorElement クラス
特定の HTTP エラーへの応答を構成します。
構文
class HttpErrorElement : CollectionElement
メソッド
このクラスにはメソッドが含まれていません。
プロパティ
次の表は、HttpErrorElement クラスによって公開されるプロパティの一覧です。
| 名前 | 説明 |
|---|---|
Path |
StatusCode と SubStatusCode の両プロパティで指定された HTTP エラーに応答して提供されるファイル名または URL が含まれる、必須の読み取り/書き込みの string 値。 |
PrefixLanguageFilePath |
カスタム エラー ページ ディレクトリの物理パスを指定する、オプションの読み取り/書き込みの string 値。 カスタム エラー ページ ディレクトリには、StatusCode プロパティで指定されたエラーのカスタム エラー ページを含む、1 つ以上の言語固有のサブディレクトリが含まれています。ファイル パスは、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 |
StatusCode と SubStatusCode で指定された HTTP エラーへの応答を指定する、必須の読み取り/書き込みの sint32 値。 使用できる値の一覧は、後述の「注釈」セクションに示します。 |
StatusCode |
400 から 999 までの状態コードを含む、必須の一意の読み取り/書き込みの uint32 値。 キー プロパティ。 |
SubStatusCode |
-1 から 999 までの状態コードを含む、必須の一意の読み取り/書き込みの sint32 値。 既定値は -1 です。 キー プロパティ。 |
サブクラス
このクラスにはサブクラスが含まれていません。
解説
このクラスのインスタンスは、HttpErrorsSection クラスの HttpErrors 配列プロパティに含まれています。
このクラスは、ApplicationHost.config ファイルの <httpErrors> セクション内の <error> 要素を表します。
次の表に、ResponseMode プロパティに設定可能な値とキーワードを示します。 既定値は 0 (File) です。
| Value | キーワード | 説明 |
|---|---|---|
| 0 | File |
Web サーバーは、Path プロパティで指定された Web ページを返します。 |
| 1 | ExecuteURL |
Web サーバーは、Path プロパティで指定された ASP ページを返します。 |
| 2 | Redirect |
Web サーバーは、Path で指定された URL に要求をリダイレクトします。 |
継承階層
HttpErrorElement
要件
| 型 | 説明 |
|---|---|
| クライアント | - Windows Vista 上の IIS 7.0 - 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 |
| Product | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF ファイル | WebAdministration.mof |
参照
CollectionElement クラス
HttpErrorsSection クラス
カスタム エラー メッセージの構成
IIS 状態コード