<switches> の <add> 要素
トレース スイッチを設定するレベルを指定します。
<add name="switch name"
value="value"/>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
説明 |
|---|---|
name |
必須の属性です。 スイッチの名前を指定します。 この属性の値は、スイッチ コンストラクターに渡される displayName パラメーターと一致します。 |
value |
必須の属性です。 スイッチのレベルを指定します。 |
子要素
なし。
親要素
要素 |
説明 |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。 |
switches |
トレース スイッチとトレース スイッチを設定するレベルを保持します。 |
system.diagnostics |
メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。 |
解説
トレース スイッチのレベルは、構成ファイル内に配置することにより変更できます。 スイッチが BooleanSwitch の場合は、スイッチのオン/オフを切り替えることができます。 スイッチが TraceSwitch の場合は、スイッチにさまざまなレベルを割り当てて、アプリケーションが出力するトレース メッセージまたはデバッグ メッセージの型を指定できます。
使用例
<add> 要素を使用して General トレース スイッチを TraceLevel.Error レベルに設定し、Data ブール型トレース スイッチを有効にする方法を次の例に示します。
<configuration>
<system.diagnostics>
<switches>
<add name="General" value="4" />
<add name="Data" value="1" />
</switches>
</system.diagnostics>
</configuration>