EventProviderTraceListener 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.
Ein Listener für TraceSource, der Ereignisse in das ETW-Subsystem schreibt.
public ref class EventProviderTraceListener : System::Diagnostics::TraceListenerpublic class EventProviderTraceListener : System.Diagnostics.TraceListenertype EventProviderTraceListener = class
inherit TraceListenerPublic Class EventProviderTraceListener
Inherits TraceListener- Vererbung
Beispiele
private static Guid providerId = new Guid("{B3F0C8FC-E8A8-4868-8901-1465E8A2F41B}");
EventProviderTraceListener listener = new EventProviderTraceListener(providerId.ToString(), "Test Listener", "::");
// You should use the All default level and control the level using the
// ETW session; otherwise, you may not log all the events requested by the
// session.
TraceSource source = new TraceSource("MyProvider", SourceLevels.All);
source.Listeners.Add(listener);
source.TraceData(TraceEventType.Warning | TraceEventType.Start, 2, new object[] { "abc", "def", true, 123 });
source.TraceEvent(TraceEventType.Warning, 12, "Provider guid: {0}", new object[] { providerId });
source.TraceInformation("string {0}, bool {1}, int {2}, ushort {3}", new object[] { "abc", false, 123, (UInt32)5 });
Hinweise
Alle Ereignisdaten (Ablaufverfolgung oder Debug) aus dem Quellereignis werden als Zeichenfolge in das ETW-Subsystem geschrieben. Die Datenelemente werden durch ein Komma getrennt. Verwenden Sie die Delimiter -Eigenschaft, um ein anderes Trennzeichen anzugeben.
Durch Hinzufügen des Listeners zum System.Diagnostics.TraceSource Registrieren des Anbieters beim ETW-Subsystem. Sie müssen eine ETW-Ablaufverfolgungssitzung mit dem Logman.exe ausführbaren Programm (oder ähnlichem) erstellen, um die Ereignisse in eine Protokolldatei zu schreiben.
Sie benötigen kein Manifest, um Ereignisse aus dem Listener zu nutzen, da die Ereignisdaten eine einzelne Zeichenfolge sind.
Wenn Sie die Methoden zum Schreiben von System.Diagnostics.TraceSource Ereignissen aufrufen, übergeben Sie einen System.Diagnostics.TraceEventType Enumerationswert. Die Enumeration enthält sowohl Ebenen- als auch Schlüsselwortwerte. Wenn Sie einen Ablaufverfolgungslisteneranbieter aus einer ETW-Sitzung aktivieren, kann der von Ihnen angegebene Levelwert der Wert sein, der einem der folgenden System.Diagnostics.TraceEventType Enumerationswerte zugeordnet ist:
Kritisch (Wert ist 1)
Fehler (Wert ist 2)
Informationen (Wert ist 8)
Ausführlich (Wert ist 16)
Warnung (Wert ist 4)
Der Schlüsselwortwert, den Sie für die Sitzung angeben, kann der Wert sein, der einem der folgenden System.Diagnostics.TraceEventType Enumerationswerte zugeordnet ist:
Lebenslauf (Wert ist 2.048)
Start (Wert ist 256)
Stop (Wert ist 512)
Anhalten (Wert ist 1.024)
Übertragung (Wert ist 4.096)
Konstruktoren
| EventProviderTraceListener(String) |
Initialisiert eine neue Instanz der EventProviderTraceListener-Klasse unter Verwendung des angegebenen Anbieterbezeichners. |
| EventProviderTraceListener(String, String) |
Initialisiert eine neue Instanz der EventProviderTraceListener-Klasse unter Verwendung des angegebenen Anbieterbezeichners und des angegebenen Namens des Listeners. |
| EventProviderTraceListener(String, String, String) |
Initialisiert eine neue Instanz der EventProviderTraceListener-Klasse unter Verwendung des angegebenen Anbieterbezeichners, des angegebenen Namens des Listeners und des angegebenen Trennzeichens. |
Eigenschaften
| Attributes |
Ruft die benutzerdefinierten Attribute für Ablaufverfolgungslistener ab, die in der Anwendungskonfigurationsdatei definiert sind. (Geerbt von TraceListener) |
| Delimiter |
Ruft das Trennzeichen ab, mit dem die in das ETW-Subsystem geschriebenen Ereignisdaten getrennt werden, oder legt dieses fest. |
| Filter |
Ruft den Ablaufverfolgungsfilter für den Ablaufverfolgungslistener ab oder legt diesen fest. (Geerbt von TraceListener) |
| IndentLevel |
Ruft die Einzugsebene ab oder legt diese fest. (Geerbt von TraceListener) |
| IndentSize |
Ruft die Anzahl der Leerzeichen in einem Einzug ab oder legt diese fest. (Geerbt von TraceListener) |
| IsThreadSafe |
Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungslistener threadsicher ist. |
| Name |
Ruft einen Namen für diesen TraceListener ab oder legt diesen fest. (Geerbt von TraceListener) |
| NeedIndent |
Ruft einen Wert ab, der einen Einzug für die Ausgabe angibt, oder legt diesen fest. (Geerbt von TraceListener) |
| TraceOutputOptions |
Ruft die Optionen für die Ablaufverfolgungsausgabe ab oder legt diese fest. (Geerbt von TraceListener) |
Methoden
| Close() |
Schließt den Ausgabedatenstrom, sodass dieser keine Ablaufverfolgungs- oder Debugausgaben mehr empfängt. |
| CreateObjRef(Type) |
Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject) |
| Dispose() |
Gibt alle vom TraceListener verwendeten Ressourcen frei. (Geerbt von TraceListener) |
| Dispose(Boolean) |
Gibt die von TraceListener verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von TraceListener) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| Fail(String) |
Gibt eine Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| Fail(String, String) |
Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen. |
| Flush() |
Leert den Ausgabepuffer. |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
| GetSupportedAttributes() |
Ruft die vom Ablaufverfolgungslistener unterstützten benutzerdefinierten Attribute ab. |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Schreibt Ablaufverfolgungsinformationen, ein Datenobjekt und Ereignisinformationen in die spezifische Ausgabe des Listeners. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Schreibt Ablaufverfolgungsinformationen, ein Datenobjekt und Ereignisinformationen in die spezifische Ausgabe des Listeners. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Schreibt Ablaufverfolgungs- und Ereignisinformationen in die spezifische Ausgabe des Listeners. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in die spezifische Ausgabe des Listeners. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in die spezifische Ausgabe des Listeners. |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Schreibt Ablaufverfolgungsinformationen, eine Meldung, eine verwandte Aktivitätsidentität und Ereignisinformationen in die spezifische Ausgabe des Listeners. |
| Write(Object) |
Schreibt den Wert der ToString()-Methode des Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| Write(Object, String) |
Schreibt einen Kategorienamen und den Wert der ToString()-Methode eines Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| Write(String) |
Schreibt beim Überschreiben in einer abgeleiteten Klasse die angegebene Meldung in den Listener, den Sie in der abgeleiteten Klasse erstellen. |
| Write(String, String) |
Schreibt einen Kategorienamen und eine Meldung in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| WriteIndent() |
Schreibt den Einzug in den Listener, den sie bei der Implementierung dieser Klasse erstellen, und setzt die NeedIndent-Eigenschaft auf |
| WriteLine(Object) |
Schreibt den Wert der ToString()-Methode des Objekts gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| WriteLine(Object, String) |
Schreibt einen Kategorienamen und den Wert der ToString()-Methode eines Objekts gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
| WriteLine(String) |
Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Meldung gefolgt von einem Zeilenabschluss in den Listener, den Sie in der abgeleiteten Klasse erstellen. |
| WriteLine(String, String) |
Schreibt einen Kategorienamen und eine Meldung gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener) |
