<trace> の <listeners> の <remove> 要素

2011-08-09

Listeners コレクションからリスナーを削除します。

<remove name="listener name" />

属性および要素

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

属性

属性	説明
name	必須の属性です。 Listeners コレクションから削除するリスナーの名前。

name

必須の属性です。

Listeners コレクションから削除するリスナーの名前。

子要素

なし。

親要素

要素	説明
configuration	共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
listeners	メッセージを収集、格納、およびルーティングするリスナーを指定します。リスナーは、トレース出力を適切なターゲットに転送します。
system.diagnostics	メッセージを収集、格納、およびルーティングするトレースリスナーとトレーススイッチを設定するレベルを指定します。
trace	ASP.NET トレースサービスを設定します。

解説

メモ
Listeners コレクションから DefaultTraceListener を削除すると、Debug.Assert、Trace.Assert、Debug.Fail、および Trace.Fail の各メソッドの動作が変わります。Assert メソッドまたは Fail メソッドを呼び出すと、通常はメッセージボックスが表示されますが、Listeners コレクションに DefaultTraceListener がない場合はメッセージボックスが表示されません。

Listeners コレクションから DefaultTraceListener を削除すると、Debug.Assert、Trace.Assert、Debug.Fail、および Trace.Fail の各メソッドの動作が変わります。Assert メソッドまたは Fail メソッドを呼び出すと、通常はメッセージボックスが表示されますが、Listeners コレクションに DefaultTraceListener がない場合はメッセージボックスが表示されません。

使用例

トレース Listeners コレクションから既定のトレースリスナーを削除する方法を次の例に示します。

<configuration>
   <system.diagnostics>
      <trace autoflush="true" indentsize="0">
         <listeners>
            <remove name="Default" />
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>