<source> の <listeners> 要素

更新 : 2007 年 11 月

TraceSource の Listeners コレクションでリスナを追加または削除します。リスナにより、トレース出力が適切な場所 (ログ、ウィンドウ、またはテキスト ファイルなど) に送られます。

<configuration> 要素
  <system.diagnostics> 要素
    <sources> 要素
      <source> 要素
        <source> の <listeners> 要素

<listeners> 
  <add>...</add>
  <remove ... />
  <clear/>
</listeners>

属性と要素

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

属性

なし

子要素

要素	説明
<source> の <listeners> の <add> 要素	Listeners コレクションにリスナを追加します。
<source> の <listeners> の <remove> 要素	Listeners コレクションからリスナを削除します。
<source> の <listeners> の <clear> 要素	トレース ソースの 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>

参照

概念

トレース リスナ

参照

トレースおよびデバッグ設定のスキーマ

TraceListener