<system.diagnostics> 要素

  • [アーティクル]

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

configuration
  <system.diagnostics>

構文

<system.diagnostics>
</system.diagnostics>

属性および要素

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

属性

なし。

子要素

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

親要素

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

例

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

Note

.NET Framework バージョン 2.0 では、テキストを使ってスイッチの値を指定できます。 たとえば、BooleanSwitch に対して true を指定したり、TraceSwitch に対して列挙値のテキスト形式である Error を使用したりできます。 <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>

関連項目