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 mehrstufigen Switch bereit, um die Ablaufverfolgung zu steuern und die Ausgabe zu debuggen, ohne den Code neu zu kompilieren.
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 Schalters bereit. Die Level Eigenschaft ruft den Wert des Schalters ab oder legt den Wert fest TraceLevel .
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 codespezifischen Code erstellen und die Ebene direkt festlegen, um einen bestimmten Codeabschnitt zu instrumentieren.
Bearbeiten Sie zum Konfigurieren einer SourceSwitchKonfigurationsdatei, 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 wird false, wird die Ablaufverfolgung ignoriert und die Ablaufverfolgungsmethode beendet. Wenn die ShouldTrace Methode zurückgegeben truewird, wird die Ablaufverfolgung an die Listener übergeben.
Konstruktoren
| Name | Beschreibung |
|---|---|
| SourceSwitch(String, String) |
Initialisiert eine neue Instanz der SourceSwitch Klasse, wobei der Anzeigename und der Standardwert für den Quellschalter angegeben werden. |
| SourceSwitch(String) |
Initialisiert eine neue Instanz der SourceSwitch Klasse, die den Namen der Quelle angibt. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Attributes |
Ruft die in der Anwendungskonfigurationsdatei definierten benutzerdefinierten Switchattribute ab. (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 ab, der zum Identifizieren des Schalters verwendet wird. (Geerbt von Switch) |
| Level |
Dient zum Abrufen oder Festlegen der Ebene des Schalters. |
| SwitchSetting |
Dient zum Abrufen oder Festlegen der aktuellen Einstellung für diesen Schalter. (Geerbt von Switch) |
| Value |
Dient zum Abrufen oder Festlegen des Werts des Schalters. (Geerbt von Switch) |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetSupportedAttributes() |
Ruft die benutzerdefinierten Attribute ab, die von der Option unterstützt werden. (Geerbt von Switch) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der 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 Ablaufverfolgungskonfigurationsdaten. (Geerbt von Switch) |
| ShouldTrace(TraceEventType) |
Bestimmt, ob Ablaufverfolgungslistener basierend auf dem Ablaufverfolgungsereignistyp aufgerufen werden sollen. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
