SourceSwitch Klasse

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Assembly:

System.dll

Assembly:

netstandard.dll

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 bereit, um die Ereignisebene des Schalters zu testen. Die Level Eigenschaft ruft den Wert des Schalters TraceLevel ab oder legt diesen fest.

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

Zum Konfigurieren einer SourceSwitch, bearbeiten Sie die Konfigurationsdatei, die dem Namen Ihrer Anwendung entspricht. In dieser Datei können Sie den Wert eines Schalters festlegen oder alle zuvor von der Anwendung festgelegten Schalter 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 vor dem Aufrufen der Listener auf. Wenn die ShouldTrace Methode zurückgegeben falsewird, wird die Ablaufverfolgung ignoriert, und die Ablaufverfolgungsmethode wird beendet. Wenn die ShouldTrace Methode zurückgegeben truewird, 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)
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.
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)