Freigeben über


<add>-Element für <switches>

Aktualisiert: November 2007

Gibt die Ebene an, auf der ein Ablaufverfolgungsschalter festgelegt wird.

<configuration>-Element
  <system.diagnostics>-Element
    <switches>-Element
      <add>-Element für <switches>

<add name="switch name"
     value="value"/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribut

Beschreibung

name

Erforderliches Attribut.

Gibt den Namen des Schalters an. Der Wert dieses Attributs entspricht dem Parameter displayName, der an den Schalterkonstruktor übergeben wird.

value

Erforderliches Attribut.

Gibt die Ebene des Schalters an.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element

Beschreibung

configuration

Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

switches

Enthält Ablaufverfolgungsschalter und die Ebene, auf die die Ablaufverfolgungsschalter festgelegt werden.

system.diagnostics

Gibt die Ablaufverfolgungslistener, die Meldungen sammeln, speichern und weiterleiten, sowie die Ebene an, auf der ein Ablaufverfolgungsschalter festgelegt wird.

Hinweise

Die Ebene eines Ablaufverfolgungsschalters können Sie ändern, indem Sie ihn in einer Konfigurationsdatei ablegen. Wenn es sich bei dem Schalter um einen BooleanSwitch handelt, können Sie ihn ein- und ausschalten. Wenn es sich um einen TraceSwitch handelt, so können Sie ihm unterschiedliche Ebenen zuweisen, um die Art der von der Anwendung ausgegebenen Ablaufverfolgungs- oder Debugmeldungen anzugeben.

Beispiel

Im folgenden Beispiel wird gezeigt, wie das <add>-Element verwendet wird, um den Ablaufverfolgungsschalter General für die Ebene TraceLevel.Error festzulegen und den booleschen Ablaufverfolgungsschalter Data zu aktivieren.

<configuration>
   <system.diagnostics>
      <switches>
         <add name="General" value="4" />
         <add name="Data" value="1" />
      </switches>
   </system.diagnostics>
</configuration>

Siehe auch

Referenz

Schema für Ablaufverfolgungs- und Debugeinstellungen

Switch

TraceSwitch

BooleanSwitch