<sharedListeners> の <add> 要素

sharedListeners コレクションにリスナーを追加します。 sharedListeners は、任意の <source> 要素 または <trace> 要素 が参照できるリスナーのコレクションです。 既定では、sharedListeners コレクションのリスナーは Listeners コレクションに配置されません。 これらは、<source> 要素 または <trace> 要素 に名前で追加する必要があります。 実行時に、sharedListeners コレクションのリスナーをコードで取得することはできません。

<add name="name" 
  type="TraceListenerClassName, Version, Culture, PublicKeyToken"
  initializeData="data"/>

属性および要素

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

属性

子要素

親要素

解説

.NET Framework に付属のリスナー クラスは、TraceListener クラスの派生クラスです。 name 属性の値は、トレースまたはトレース ソースの Listeners コレクションに共有リスナーを追加するために使用されます。 initializeData 属性の値は、作成するリスナーの型によって異なります。 initializeData を指定する必要のないトレース リスナーもあります。

メモ
initializeData 属性を使用すると、"initializeData 属性は宣言されていません" というコンパイラの警告が表示される場合があります。 この警告は、initializeData 属性を認識しない TraceListener 抽象基本クラスに対して構成設定が検証されたために発生します。通常、パラメーターを受け取るコンストラクターのあるトレース リスナーの実装では、この警告を無視してもかまいません。

.NET Framework に付属するトレース リスナーを次の表に示し、各リスナーの initializeData 属性の値を説明します。

構成ファイル

この要素は、マシン構成ファイル (Machine.config) およびアプリケーション構成ファイルで使用できます。

使用例

<add> 要素を使用して、リスナー TextWriterTraceListenertextListener を sharedListeners コレクションに書き込む方法を次の例に示します。 textListener は、トレース ソース TraceSourceApp の Listeners コレクションに名前で追加されます。 textListener リスナーは、トレース出力を myListener.log ファイルに書き込みます。

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener"/>
          <add name="textListener"/>
          <remove name="Default"/>
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="textListener" 
        type="System.Diagnostics.TextWriterTraceListener" 
        initializeData="myListener.log"/>
    </sharedListeners>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration> 

参照

参照

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

TraceSource

TraceListener

概念

トレース リスナー