<system.diagnostics> 要素

更新 : 2007 年 11 月

メッセージを収集、格納、およびルーティングするトレース リスナとトレース スイッチを設定するレベルを指定します。

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

<system.diagnostics> 
</system.diagnostics>

属性と要素

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

属性

なし。

子要素

要素	説明
<assert>	Debug.Assert メソッドの呼び出し時にメッセージ ボックスを表示するかどうかを指定し、メッセージの書き込み先のファイルの名前も指定します。
<performanceCounters>	パフォーマンス カウンタが共有するグローバル メモリのサイズを指定します。
<sharedListeners>	任意の source 要素または trace 要素が参照できるリスナを含みます。共有リスナとして識別されたリスナは、ソースまたはトレースに名前で追加できます。
<sources>	トレース メッセージを開始するトレース ソースを指定します。
<switches>	トレース スイッチとトレース スイッチを設定するレベルを保持します。
<trace>	トレース メッセージを収集、格納、およびルーティングするリスナを保持します。

親要素

要素	説明
configuration	共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。

使用例

<system.diagnostics> 要素の中にトレース スイッチおよびトレース リスナを埋め込む方法を次の例に示します。General トレース スイッチは、TraceLevel.Error レベルに設定されています。トレース リスナ myListener は、MyListener.log というファイルを作成し、そのファイルに出力を書き込みます。

メモ :
.NET Framework Version 2.0 では、テキストを使用してスイッチの値を指定できます。たとえば、BooleanSwitch に true を指定したり、Error などの列挙値を表すテキストを TraceSwitch に使用したりできます。<add name="myTraceSwitch" value="Error" /> 行は、<add name="myTraceSwitch" value="1" /> に相当します。

<configuration>
   <system.diagnostics>
      <switches>
         <add name="General" value="4" />
      </switches>
      <trace autoflush="true" indentsize="2">
         <listeners>
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="MyListener.log" traceOutputOptions="ProcessId, LogicalOperationStack, Timestamp, ThreadId, Callstack, DateTime" />
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>

参照

参照

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

Trace

Debug