<customErrors> 要素

このトピックの対象は、既存のアプリケーションとの下位互換性のために残されているレガシ テクノロジに特定されています。新規の開発には、このトピックを適用しないでください。分散アプリケーションは、現在は Windows Communication Foundation (WCF) を使用して開発する必要があります。

このアプリケーション ドメインのサーバー チャネルによって、ローカルまたはリモートの呼び出し元に対して、フィルター処理した例外情報を返すか、またはすべての例外情報を返すかを指定します。この要素は、アプリケーション構成ファイルまたはマシン構成ファイルに出現する可能性があります。この要素は、Microsoft Windows 98 以降の .NET Framework Version 1.1 以降でサポートされています。

Schema Hierarchy

<configuration>
  <system.runtime.remoting> 要素
    <customErrors> 要素

構文

<customErrors  
   mode="Off|On|RemoteOnly" 
/>

属性と要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

子要素

なし。

親要素

解説

完全な例外情報には、厳密なサーバー例外とサーバー スタック トレースが含まれます。フィルター処理された情報には、標準リモート処理例外が含まれますが、サーバー スタック トレースは含まれません。

例外情報を受け取る呼び出し元と受け取る情報の種類を指定するサーバー チャネル プロパティの 3 つの値を次の表に示します。

例

.NET Framework リモート処理システムに対して、クライアント ドメインが、コールバックとして使用されるデリゲートを渡せるように、クライアント アプリケーション ドメインに代わってサーバー チャネルを登録するように指示する構成ファイルの例を次に示します。<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>

参照

リファレンス

リモート処理設定スキーマ
System.Runtime.Remoting.RemotingConfiguration.CustomErrorsEnabled(System.Boolean)

ビルド日:2010-02-13