SourceSwitch Klasse

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Quelle:

SourceSwitch.cs

Stellt einen Schalter bereit, mit dem mehrere Ebenen ausgewählt und so Ablaufverfolgungs- und Debugausgabe gesteuert werden können, ohne dass der Code hierfür neu kompiliert werden muss.

public ref class SourceSwitch : System::Diagnostics::Switch

public class SourceSwitch : System.Diagnostics.Switch

type SourceSwitch = class
    inherit Switch

Public Class SourceSwitch
Inherits Switch

Vererbung

Object

Switch

SourceSwitch

Hinweise

Die Switch -Eigenschaft der TraceSource -Klasse ist ein SourceSwitch -Objekt. Die SourceSwitch -Klasse stellt eine Level Eigenschaft zum Testen der Ereignisebene des Switches bereit. Die Level -Eigenschaft ruft den Wert des TraceLevel Switches ab oder legt diese fest.

Sie können die Ereignisebene eines SourceSwitch über die Anwendungskonfigurationsdatei festlegen und dann die konfigurierte SourceSwitch Ebene in Ihrer Anwendung verwenden. Alternativ können Sie einen SourceSwitch in Ihrem Code erstellen und die Ebene direkt festlegen, um einen bestimmten Codeabschnitt zu instrumentieren.

Um ein SourceSwitchzu konfigurieren, bearbeiten Sie die Konfigurationsdatei, die dem Namen Ihrer Anwendung entspricht. In dieser Datei können Sie den Wert eines Switches festlegen oder alle Zuvor von der Anwendung festgelegten Switches löschen. Die Konfigurationsdatei sollte wie im folgenden Beispiel dargestellt formatiert werden.

<switches>  
  <add name="SourceSwitch" value="Verbose"></add>  
</switches>  

Der Schalter wird verwendet, um zu überprüfen, ob eine Ablaufverfolgung weitergegeben oder ignoriert werden soll. Jede TraceSource Ablaufverfolgungsmethode ruft die ShouldTrace -Methode auf, bevor die Listener aufgerufen werden. Wenn die ShouldTrace Methode zurückgibt false, wird die Ablaufverfolgung ignoriert, und die Ablaufverfolgungsmethode wird beendet. Wenn die ShouldTrace Methode zurückgibt true, wird die Ablaufverfolgung an die Listener übergeben.

Konstruktoren

SourceSwitch(String)	Initialisiert eine neue Instanz der SourceSwitch-Klasse und gibt den Namen der Quelle an.
SourceSwitch(String, String)	Initialisiert eine neue Instanz der SourceSwitch-Klasse und gibt den Anzeigenamen und den Standardwert für den Quellschalter an.

Eigenschaften

Attributes	Ruft die benutzerdefinierten Schalterattribute ab, die in der Anwendungskonfigurationsdatei definiert sind. (Geerbt von Switch)
DefaultValue	Ruft den im Konstruktor zugewiesenen Standardwert ab. (Geerbt von Switch)
Description	Ruft eine Beschreibung des Schalters ab. (Geerbt von Switch)
DisplayName	Ruft einen Namen zum Bezeichnen des Schalters ab. (Geerbt von Switch)
Level	Ruft die Ebene des Schalters ab oder legt diese fest.
SwitchSetting	Ruft die aktuelle Einstellung des Schalters ab oder legt diese fest. (Geerbt von Switch)
Value	Ruft den Wert des Schalters ab oder legt diesen fest. (Geerbt von Switch)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetSupportedAttributes()	Ruft die benutzerdefinierten Attribute ab, die vom Schalter unterstützt werden. (Geerbt von Switch)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnSwitchSettingChanged()	Wird aufgerufen, wenn die SwitchSetting-Eigenschaft geändert wird. (Geerbt von Switch)
OnValueChanged()	Wird aufgerufen, wenn sich der Wert der Value-Eigenschaft ändert.
Refresh()	Aktualisiert die Konfigurationsdaten für die Ablaufverfolgung. (Geerbt von Switch)
ShouldTrace(TraceEventType)	Bestimmt, ob Ablaufverfolgungslistener auf Grundlage des Typs des Ablaufverfolgungsereignisses aufgerufen werden sollen.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)