<sharedListeners> 要素

[アーティクル]
08/09/2011

任意の source 要素または trace 要素が参照できるリスナーを含みます。既定では、これらのリスナーはトレースを受け取りません。また、実行時にこれらのリスナーを取得することはできません。共有リスナーとして識別されたリスナーは、ソースまたはトレースに名前で追加できます。

<sharedListeners> 
  <add>...</add>
</sharedListeners>

属性および要素

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

属性

なし。

子要素

要素	説明
<trace> の <listeners> の <add> 要素	sharedListeners コレクションにリスナーを追加します。

親要素

要素	説明
Configuration	共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
system.diagnostics	ASP.NET 構成セクションのルート要素を指定します。

解説

リスナーを共有リスナーのコレクションに追加しても、アクティブなリスナーにはなりません。リスナーをさらにその trace 要素の Listeners コレクションに追加することによって、トレースソースまたはトレースに追加する必要があります。 .NET Framework のリスナークラスは、TraceListener クラスの派生クラスです。

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

使用例

<sharedListeners> 要素を使用して、リスナー console をTraceSource クラスと Trace クラスの Listeners コレクションに追加する方法を次の例に示します。コンソールトレースリスナーは、TraceSource または Trace の呼び出しを通じて、トレース情報をコンソールに書き込みます。

<configuration>
  <system.diagnostics>
    <sharedListeners>
      <add name="console" type="System.Diagnostics.ConsoleTraceListener" >
        <filter type="System.Diagnostics.EventTypeFilter"
          initializeData="Warning" />
      </add>
    </sharedListeners>
    <sources>
      <source name="mySource" switchName="sourceSwitch"  >
        <listeners>
          <add name="console" />
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="sourceSwitch" value="Verbose"/>
    </switches>
    <trace>
      <listeners>
        <add name="console" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration></system.diagnostics>