<switches> の <add> 要素

トレース スイッチを設定するレベルを指定します。

<configuration> 要素
  <system.diagnostics> 要素
    <switches> 要素
      <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>

参照

関連項目

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