EventProviderTraceListener Klasse

  • Referenz

Definition

Namespace:
System.Diagnostics.Eventing
Assembly:
System.Core.dll

Ein Listener für TraceSource, der Ereignisse in das ETW-Subsystem schreibt.

public ref class EventProviderTraceListener : System::Diagnostics::TraceListener
public class EventProviderTraceListener : System.Diagnostics.TraceListener
type EventProviderTraceListener = class
    inherit TraceListener
Public Class EventProviderTraceListener
Inherits TraceListener
Vererbung
Object
MarshalByRefObject
TraceListener
EventProviderTraceListener

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.

Wenn Sie den Listener hinzufügen, um den Anbieter beim ETW-Subsystem zu System.Diagnostics.TraceSource registrieren. Sie müssen eine ETW-Ablaufverfolgungssitzung mit dem Logman.exe ausführbaren Programm (oder ähnlichen) erstellen, um die Ereignisse in eine Protokolldatei zu schreiben.

Sie benötigen kein Manifest, um Ereignisse vom Listener zu nutzen, da die Ereignisdaten eine einzelne Zeichenfolge sind.

Wenn Sie die System.Diagnostics.TraceSource Methoden zum Schreiben von Ereignissen aufrufen, übergeben Sie einen System.Diagnostics.TraceEventType Enumerationswert. Die -Enumeration enthält sowohl Level- als auch Schlüsselwort (keyword)-Werte. 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üsselwort (keyword) Wert, den Sie für die Sitzung angeben, kann der Wert sein, der einem der folgenden System.Diagnostics.TraceEventType Enumerationswerte zugeordnet ist:

  • Resume (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 false zurück.

(Geerbt von TraceListener)
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)

Gilt für:

Weitere Informationen