<trace> 要素

[アーティクル]
08/16/2008

更新 : 2007 年 11 月

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

<configuration> 要素
 <system.diagnostics> 要素
 <trace> 要素

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

属性と要素

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

属性

属性	説明
autoflush	省略可能属性トレースリスナが毎回の書き込み操作の後で出力バッファを自動的にフラッシュするかどうかを指定します。
indentsize	省略可能属性インデントするスペース数を指定します。
useGlobalLock	省略可能属性グローバルロックを使用する必要があるかどうかを示します。

autoflush

省略可能属性

トレースリスナが毎回の書き込み操作の後で出力バッファを自動的にフラッシュするかどうかを指定します。

indentsize

省略可能属性

インデントするスペース数を指定します。

useGlobalLock

省略可能属性

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

autoflush 属性

値	説明
false	出力バッファを自動的にフラッシュしません。これは、既定の設定です。
true	出力バッファを自動的にフラッシュします。

useGlobalLock 属性

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

子要素

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

親要素

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

使用例

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

<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>