<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>
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET