SourceSwitch Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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::Switchpublic class SourceSwitch : System.Diagnostics.Switchtype SourceSwitch = class
inherit SwitchPublic Class SourceSwitch
Inherits Switch- Vererbung
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) |
