EventListener Klasse

Definition

Namespace:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Quelle:

EventSource.cs

Diese Klasse stellt Methoden zum Aktivieren und Deaktivieren von Ereignissen aus Ereignisquellen bereit.

public ref class EventListener abstract : IDisposable

public abstract class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Vererbung

Object

EventListener

Implementiert

IDisposable

Hinweise

Ein Ereignislistener stellt das Ziel für alle Ereignisse dar, die von Implementierungen der Ereignisquelle (EventSource Objekt) in der aktuellen Anwendungsdomäne generiert werden. Wenn ein neuer Ereignislistener erstellt wird, wird er logisch an alle Ereignisquellen in dieser Anwendungsdomäne angefügt.

Hinweis

Dieser Typ implementiert die IDisposable-Schnittstelle. Wenn Sie die Verwendung des Typs abgeschlossen haben, müssen Sie ihn entweder direkt oder indirekt entsorgen. Zum direkten Löschen des Typs rufen Sie seine Dispose-Methode in einem try/catch-Block auf. Zum indirekten Löschen verwenden Sie ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt „Verwenden eines Objekts, das IDisposable implementiert“ des Themas „Die IDisposable-Schnittstelle“.

Ein Ereignislistener kann auf Basis der aktuellen Ereignisquelle mithilfe von Ereignisebenen (EventLevel) und Ereignisschlüsselwörtern (EventKeywords) aktivieren oder deaktivieren, um den An den Listener zu sendenden Ereignissatz weiter einzuschränken. Der Listener kann mithilfe der SendCommand -Methode auch beliebige Befehle an eine bestimmte aktuelle Ereignisquelle senden. Die Bedeutungen der Befehle sind spezifisch für die Implementierung der Ereignisquelle.

Mehrere Ereignislistener können in einer einzelnen Anwendungsdomäne definiert werden. Jeder Listener ist logisch unabhängig von den anderen Listenern, sodass Ereignisse, die von einem Listener aktiviert oder deaktiviert werden, nur diesen Listener beeinflussen. Es ist möglich, dass mit der SendCommand -Methode gesendete Befehle einen semantischen Vorgang (z. B. eine Garbage Collection oder das Leeren von Daten) ausführen, die sich auf die anderen Listener auswirken, aber dies ist die Ausnahme und nicht die Regel.

Jede Ereignisquelle enthält eine Liste der Ereignislistener, an die Ereignisse gesendet werden. Jedem Quell-Listener-Paar des Ereignisses ist eine Reihe von Filterkriterien zugeordnet. Diese Kriterien bestimmen die Ereignisse, die der Listener für die aktuelle Ereignisquelle empfängt. Listener empfangen die Ereignisse für ihre OnEventWritten Methode. Daher müssen Unterklassen von EventListener diese Methode überschreiben, um etwas Nützliches mit den Daten zu tun.

Wenn eine neue Ereignisquelle erstellt wird, wird die OnEventSourceCreated -Methode aufgerufen. Jeder aktuelle Ereignislistener erhält genau einen OnEventSourceCreated Aufruf für jede aktuelle Ereignisquelle, die Protokollnachrichten senden kann. Wenn ein Ereignislistener erstellt wird, werden eine Reihe von OnEventSourceCreated Aufrufen ausgeführt, um den neuen Listener über alle Ereignisquellen zu benachrichtigen, die vor der Erstellung des Listeners vorhanden waren.

Wichtig

Beim Instanziieren eines EventListenerkann der Rückruf an und OnEventWritten erfolgen, OnEventSourceCreatedbevor der Konstruktor abgeschlossen ist. Achten Sie darauf, wenn Sie instance Member initialisieren, die in diesen Rückrufen verwendet werden.

Konstruktoren

EventListener()

Erstellt eine neue Instanz der EventListener-Klasse.

Methoden

DisableEvents(EventSource)	Deaktiviert alle Ereignisse für die angegebene Ereignisquelle.
Dispose()	Gibt alle von der aktuellen Instanz der EventListener-Klasse verwendeten Ressourcen frei.
EnableEvents(EventSource, EventLevel)	Aktiviert Ereignisse für die angegebene Ereignisquelle, die die angegebene Ausführlichkeitsgrad oder niedriger aufweist.
EnableEvents(EventSource, EventLevel, EventKeywords)	Aktiviert Ereignisse für die angegebene Ereignisquelle, die den angegebenen Ausführlichkeitsgrad oder niedriger aufweist, und die entsprechenden Schlüsselwort-Flags.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Aktiviert Ereignisse für die angegebene Ereignisquelle, die die angegebene Ausführlichkeitsgrad oder niedriger aufweist, übereinstimmendes Schlüsselwortereignisflag und entsprechende Argumente.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
EventSourceIndex(EventSource)	Ruft eine kleine nicht negative Zahl ab, die die angegebene Ereignisquelle darstellt.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnEventSourceCreated(EventSource)	Wird für alle vorhandenen Ereignisquellen aufgerufen, wenn der Ereignislistener erstellt wird, und wenn eine neue Ereignisquelle zum Listener angefügt wird.
OnEventWritten(EventWrittenEventArgs)	Wird aufgerufen, wenn ein Ereignis von einer Ereignisquelle geschrieben wurde, für die der Ereignislistener Ereignisse aktiviert hat.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

EventSourceCreated	Tritt auf, wenn eine Ereignisquelle (EventSource-Objekt) an den Verteiler angefügt ist.
EventWritten	Tritt auf, wenn ein Ereignis von einer Ereignisquelle (EventSource-Objekt) geschrieben wurde, für die der Ereignislistener Ereignisse aktiviert hat.