<trace> の <listeners> 要素

  • [アーティクル]

メッセージを収集、格納、およびルーティングするリスナーを指定します。 リスナーにより、トレース出力が適切な場所に送られます。

configuration
  <system.diagnostics>
    <trace>
      <listeners>

構文

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

属性および要素

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

属性

なし。

子要素

要素 説明
<add> Listeners コレクションにリスナーを追加します。
<clear> トレースの Listeners コレクションを削除します。
<remove> Listeners コレクションからリスナーを削除します。

親要素

要素 説明
configuration 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
system.diagnostics ASP.NET 構成セクションのルート要素を指定します。
trace トレース メッセージを収集、格納、およびルーティングするリスナーを保持します。

解説

Debug クラスと Trace クラスでは、同じ Listeners コレクションが共有されます。 これらのクラスのいずれかのコレクションにリスナー オブジェクトを追加すると、もう一方のクラスでも同じリスナーが使用されます。 .NET Framework に付属しているリスナー クラスは、TraceListener クラスから派生したものです。

構成ファイル

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

例

次の例では、<listeners> 要素を使用して、リスナー MyListener および MyEventListener を Listeners コレクションに追加する方法を示しています。 MyListener では、MyListener.log というファイルを作成し、そのファイルに出力を書き込みます。 MyEventListener では、イベント ログにエントリを書き込みます。

<configuration>  
  <system.diagnostics>  
    <trace autoflush="true" indentsize="0">  
      <listeners>  
        <add name="myListener"
          type="System.Diagnostics.TextWriterTraceListener,
            system, version=1.0.3300.0, Culture=neutral,
            PublicKeyToken=b77a5c561934e089"
          initializeData="c:\myListener.log" />  
        <add name="MyEventListener"  
          type="System.Diagnostics.EventLogTraceListener,
            system, version=1.0.3300.0, Culture=neutral,
            PublicKeyToken=b77a5c561934e089"  
          initializeData="MyConfigEventLog"/>  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

関連項目