<customErrors> 要素
このアプリケーションのサーバー チャネルによって、ローカルまたはリモートの呼び出し元に対して、フィルタ処理した例外情報を返すか、またはすべての例外情報を返すかを指定します。
<configuration>
<system.runtime.remoting>
<customErrors>
<customErrors
mode="off|on|remoteOnly"
/>
必須属性
| 属性 | 説明 |
|---|---|
| mode | このアプリケーションのサーバー チャネルによって、ローカルまたはリモートの呼び出し元に対して、フィルタ処理した例外情報を返すか、またはすべての例外情報を返すかを指定します。既定は remoteOnly で、完全な例外情報 (スタック トレースを含む) をサーバーと同じコンピュータの呼び出し元だけに返します。 |
解説
完全な例外情報には、厳密なサーバー例外とサーバー スタック トレースが含まれます。フィルタ処理された情報には、標準リモート処理例外が含まれますが、サーバー スタック トレースは含まれません。
例外情報を受け取る呼び出し元と受け取る情報の種類を指定するサーバー チャネル プロパティの 3 つの値を次の表に示します。
| Value | 説明 |
|---|---|
| off | すべての呼び出し元は、完全な例外情報を受け取ります。 |
| on | すべての呼び出し元は、フィルタ処理された例外情報を受け取ります。 |
| remoteOnly | ローカルの呼び出し元は完全な例外情報を受け取り、リモートの呼び出し元はフィルタ処理された例外情報を受け取ります。 |
例
.NET リモート処理システムに対して、クライアント ドメインが、コールバックとして使用されるデリゲートを渡せるように、クライアント アプリケーション ドメインに代わってサーバー チャネルを登録するように指示する構成ファイルの例を次に示します。<customErrors mode="off"/> を指定することにより、コールバック時にクライアントで例外が発生したときに、サーバーはスタック トレースを含む完全な例外情報を受け取ることができます。
<configuration>
<system.runtime.remoting>
<application>
<client url="http://computername:8080">
<activated type="ClientActivatedType, RemoteType"/>
</client>
<channels>
<channel ref="http" port="0">
<serverProviders>
<formatter ref="soap" typeFilterLevel="Full"/>
<formatter ref="binary" typeFilterLevel="Full"/>
</serverProviders>
</channel>
</channels>
</application>
<customErrors mode="off"/>
</system.runtime.remoting>
</configuration>
必要条件
構成ファイル : アプリケーション構成ファイル、マシン構成ファイル (Machine.config)
プラットフォーム : この要素は、Microsoft Windows 98 以降の .NET Framework Version 1.1 以降でサポートされています。