<trace> 要素

  • [アーティクル]

トレース メッセージを収集、格納、およびルーティングするリスナーを保持します。

configuration
  <system.diagnostics>
    <trace>

構文

<trace autoflush="true|false"
       indentsize="indent value"  
       useGlobalLock="true| false"/>

属性および要素

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

属性

属性 説明
autoflush 省略可能な属性です。

書き込み操作のたびに、トレース リスナーによって出力バッファーが自動的にフラッシュされるかどうかを指定します。
indentsize 省略可能な属性です。

インデントするスペースの数を指定します。
useGlobalLock 省略可能な属性です。

グローバル ロックを使用するかどうかを示します。

autoflush 属性

[値] 説明
false 出力バッファーを自動的にフラッシュしません。 既定値です。
true 出力バッファーを自動的にフラッシュします。

useGlobalLock 属性

[値] 説明
false リスナーがスレッド セーフの場合は、グローバル ロックを使用しません。それ以外の場合は、グローバル ロックを使用します。
true リスナーがスレッド セーフであるかどうかに関係なく、グローバル ロックを使用します。 既定値です。

子要素

要素 説明
<listeners> メッセージを収集、格納、およびルーティングするリスナーを指定します。

親要素

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

例

次の例は、<trace> 要素を使用してリスナー MyListener を Listeners コレクションに追加する方法を示しています。 MyListener により、MyListener.log という名前のファイルが作成され、その出力がファイルに書き込まれます。 useGlobalLock 属性は false に設定されます。これにより、トレース リスナーがスレッド セーフである場合、グローバル ロックは使用されません。 autoflush 属性は true に設定されます。これにより、Trace.Flush メソッドが呼び出されたかどうかに関係なく、トレース リスナーからファイルに書き込まれます。 indentsize 属性は 0 (ゼロ) に設定されます。これにより、Trace.Indent メソッドが呼び出されたときに、リスナーによってゼロ スペースがインデントされます。

<configuration>  
   <system.diagnostics>  
      <trace useGlobalLock="false" 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" />  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

関連項目