<system. diagnostics > 要素<system.diagnostics> Element

メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。Specifies trace listeners that collect, store, and route messages and the level where a trace switch is set.

<configuration> <configuration>
   <system.diagnostics>  <system.diagnostics>



属性および要素Attributes and Elements

以降のセクションでは、属性、子要素、および親要素について説明します。The following sections describe attributes, child elements, and parent elements.


[なし] :None.

子要素Child Elements

要素Element 説明Description
<assert><assert> Debug.Assert メソッドの呼び出し時にメッセージ ボックスを表示するかどうかを指定し、メッセージの書き込み先のファイルの名前も指定します。Specifies whether to display a message box when you call the Debug.Assert method; also specifies the name of the file to write messages to.
<performanceCounters><performanceCounters> パフォーマンス カウンターが共有するグローバル メモリのサイズを指定します。Specifies the size of the global memory shared by performance counters.
<sharedListeners><sharedListeners> 任意の source 要素または trace 要素が参照できるリスナーを含みます。Contains listeners that any source or trace element can reference. 共有リスナーとして識別されるリスナーは、名前を指定してソースまたはトレースに追加できます。Listeners identified as shared listeners can be added to sources or traces by name.
<sources><sources> トレースメッセージを開始するトレースソースを指定します。Specifies trace sources that initiate tracing messages.
<switches><switches> トレーススイッチと、トレーススイッチが設定されているレベルを格納します。Contains trace switches and the levels where the trace switches are set.
<trace><trace> トレース メッセージを収集、格納、およびルーティングするリスナーを保持します。Contains listeners that collect, store, and route tracing messages.

親要素Parent Elements

要素Element 説明Description
configuration 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。The root element in every configuration file used by the common language runtime and .NET Framework applications.


次の例は、トレーススイッチとトレースリスナーを <system. diagnostics > 要素内に埋め込む方法を示しています。The following example shows how to embed a trace switch and a trace listener inside the <system.diagnostics> element. @No__t-0 トレーススイッチが TraceLevel レベルに設定されています。The General trace switch is set to the TraceLevel level. トレースリスナー myListener は、MyListener.log という名前のファイルを作成し、出力をファイルに書き込みます。The trace listener myListener creates a file called MyListener.log and writes the output to the file.


.NET Framework バージョン 2.0 では、スイッチの値を指定するためにテキストを使用できます。In the .NET Framework version 2.0, you can use text to specify the value for a switch. たとえば、BooleanSwitch の場合は true を指定し、TraceSwitch の場合は Error などの列挙値を表すテキストを使用します。For example, you can specify true for a BooleanSwitch or use the text representing an enumeration value such as Error for a TraceSwitch. <add name="myTraceSwitch" value="Error" /> という行は、<add name="myTraceSwitch" value="1" /> と同じです。The line <add name="myTraceSwitch" value="Error" /> is equivalent to <add name="myTraceSwitch" value="1" />.

         <add name="General" value="4" />  
      <trace autoflush="true" indentsize="2">  
            <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" />  

関連項目See also