TraceSource の Listeners コレクションでリスナーを追加または削除します。 リスナーにより、トレース出力が適切な場所 (ログ、ウィンドウ、またはテキスト ファイルなど) に送られます。
<listeners>
<add>...</add>
<remove ... />
<clear/>
</listeners>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
なし。
子要素
要素 |
説明 |
|---|---|
Listeners コレクションにリスナーを追加します。 |
|
Listeners コレクションからリスナーを削除します。 |
|
トレース ソースの Listeners コレクションを削除します。 |
親要素
要素 |
説明 |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。 |
system.diagnostics |
メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。 |
sources |
トレース メッセージを開始するトレース ソースを保持します。 |
source |
トレース メッセージを開始するトレース ソースを指定します。 |
解説
構成ファイル
この要素は、マシン構成ファイル (Machine.config) およびアプリケーション構成ファイルで使用できます。
使用例
<listeners> 要素を使用して、コンソール トレース リスナーを mySource ソースに追加し、既定のトレース リスナーを削除する例を次に示します。
<configuration>
<system.diagnostics>
<sources>
<source name="mySource" switchName="sourceSwitch"
switchType="System.Diagnostics.SourceSwitch">
<listeners>
<add name="console"
type="System.Diagnostics.ConsoleTraceListener">
<filter type="System.Diagnostics.EventTypeFilter"
initializeData="Error"/>
</add>
<remove name="Default"/>
</listeners>
</source>
</sources>
<switches>
<add name="sourceSwitch" value="Warning"/>
</switches>
</system.diagnostics>
</configuration>