customErrors 要素 (ASP.NET 設定スキーマ)
[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]
ASP.NET アプリケーションのカスタム エラー メッセージについての情報が用意されています。 customErrors 要素は、アプリケーション ファイル階層の任意のレベルで定義できます。
<customErrors defaultRedirect="url"
mode="On|Off|RemoteOnly">
<error. . ./>
</customErrors>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
Description |
|---|---|
defaultRedirect |
省略可能な属性です。 エラーが発生した場合に、ブラウザーをリダイレクトする先の既定の URL を指定します。 この属性が指定されていない場合は、代わりに汎用エラーが表示されます。 URL の指定は、絶対 URL (www.contoso.com/ErrorPage.htm など) でも相対 URL でもかまいません。 /ErrorPage.htm のような相対 URL は、この属性で使用する URL を指定した Web.config ファイルが基準の相対 URL であり、エラーが発生した Web ページが基準の相対 URL ではありません。 ~/ErrorPage.htm のようにティルダ (~) で始まる URL は、指定された URL がアプリケーションのルート パスが基準の相対パスであることを意味します。 |
mode |
必須の属性です。 カスタム エラーを有効にするか、無効にするか、またはリモート クライアントだけに出力するかを指定します。 この属性には、次のいずれかの値を指定できます。
値Description
On カスタム エラーが有効であることを指定します。defaultRedirect 属性が指定されていない場合は、ユーザーに対して汎用エラーが表示されます。カスタム エラーはリモート クライアントとローカル ホストに対して表示されます。
Off カスタム エラーが無効であることを指定します。詳細な ASP.NET エラーはリモート クライアントとローカル ホストに対して表示されます。
RemoteOnly カスタム エラーがリモート クライアントだけに出力され、ASP.NET エラーがローカル ホストに出力されることを指定します。これが既定値です。
既定値は、RemoteOnly です。 |
redirectMode |
省略可能な属性です。 カスタム エラー ページが表示されたときに、元の要求の URL をどのように処理するかを決定するための値を指定します。 この属性には、次のいずれかの値を指定できます。
値Description
ResponseRedirect ブラウザーの参照先となる URL が、元の Web 要求 URL とは異なる URL である必要があることを指定します。
ResponseRewrite ブラウザーの参照先となる URL が、元の Web 要求 URL である必要があることを指定します。
|
子要素
要素 |
Description |
|---|---|
error |
省略可能な要素です。 指定された HTTP ステータス コードのカスタム エラー ページを指定します。 error タグは、複数回指定できます。 それぞれのサブタグが、1 つのカスタム エラー条件を定義します。 |
親要素
要素 |
Description |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素を指定します。 |
system.web |
構成ファイルの ASP.NET 構成設定のルート要素を指定します。ASP.NET Web アプリケーションを構成する構成要素やアプリケーションの動作を制御する構成要素が含まれます。 |
解説
既定の構成
次の既定の customErrors 要素は、.NET Framework Version 1.0 および 1.1 の Machine.config ファイルで構成されます。
<customErrors mode="RemoteOnly" />
使用例
ASP.NET アプリケーションで使用するエラー処理ページを指定する方法を、次の構成例に示します。
<configuration>
<system.web>
<customErrors defaultRedirect="GenericError.htm"
mode="RemoteOnly">
<error statusCode="500"
redirect="InternalError.htm"/>
</customErrors>
</system.web>
</configuration>
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
Machine.config ルート レベルの Web.config アプリケーション レベルの Web.config 仮想ディレクトリ レベルまたは物理ディレクトリ レベルの Web.config |
要件 |
Microsoft Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0 .NET Framework Version 1.0、1.1、または 2.0 Microsoft Visual Studio 2003 または Visual Studio 2005 |
参照
処理手順
How to: Lock ASP.NET Configuration Settings
Reference
system.web 要素 (ASP.NET 設定スキーマ)
customErrors の error 要素 (ASP.NET 設定スキーマ)
概念
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities