EventListener Klasse

Definition

Namespace:

System.Diagnostics.Tracing

Assemblys:

mscorlib.dll, System.Diagnostics.Tracing.dll

Stellt Methoden zum Aktivieren und Deaktivieren von Ereignissen aus Ereignisquellen bereit.

public ref class EventListener : IDisposable

public class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public Class EventListener
Implements IDisposable

Vererbung

Object

EventListener

Implementiert

IDisposable

Hinweise

Ein Ereignislistener stellt das Ziel für alle Ereignisse dar, die von Ereignisquellenimplementierungen (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.

Note

Dieser Typ implementiert die IDisposable Schnittstelle. Wenn Sie die Verwendung des Typs abgeschlossen haben, müssen Sie ihn entweder direkt oder indirekt löschen. Rufen Sie die Methode Dispose in einem try/catch-Block auf, um den Typ direkt zu entsorgen. Verwenden Sie zum indirekten Löschen ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt "Verwenden eines Objekts, das IDisposable implementiert" im IDisposable Schnittstellenthema.

Ein Ereignislistener kann auf aktueller Ereignisquelle basierend auf Ereignisebenen (EventLevel) und Ereignisstichwörtern (EventKeywords) aktivieren oder deaktivieren, um den Satz von Ereignissen weiter einzuschränken, die an den Listener gesendet werden sollen. Der Listener kann auch beliebige Befehle mithilfe der SendCommand Methode an eine bestimmte aktuelle Ereignisquelle senden. Die Bedeutungen der Befehle sind spezifisch für die Implementierung der Ereignisquelle.

Mehrere Ereignislistener können in einer einzigen 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 betreffen. Es ist möglich, dass Befehle, die mit der SendCommand Methode gesendet werden, einen semantischen Vorgang (z. B. eine Garbage Collection oder das Leeren von Daten), die sich auf die anderen Listener auswirken, aber dies ist die Ausnahme anstelle der Regel.

Jede Ereignisquelle enthält eine Liste der Ereignislistener, an die ereignisse gesendet werden. Jeder Ereignisquelllistenerpaar ist eine Reihe von Filterkriterien zugeordnet. Diese Kriterien bestimmen die Ereignisse, die listener für die aktuelle Ereignisquelle empfangen. Listener empfangen die Ereignisse auf ihrer OnEventWritten Methode. Daher müssen Unterklassen dieser EventListener Methode außer Kraft setzen, um mit den Daten etwas Nützliches zu tun.

Wenn eine neue Ereignisquelle erstellt wird, wird die OnEventSourceCreated Methode aufgerufen. Jeder aktuelle Ereignislistener ruft genau einen OnEventSourceCreated Aufruf für jede aktuelle Ereignisquelle ab, die sie protokollieren 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 dem Erstellen des Listeners vorhanden waren.

Important

Beim Instanziieren einer EventListenerInstanziierung können die Rückrufe OnEventSourceCreated erfolgen und OnEventWritten vor Abschluss des Konstruktors auftreten. Achten Sie darauf, wenn Sie Instanzmber initialisieren, die in diesen Rückrufen verwendet werden.

Konstruktoren

Name	Beschreibung
EventListener()	Erstellt eine neue Instanz der EventListener Klasse.

Methoden

Name	Beschreibung
DisableEvents(EventSource)	Deaktiviert alle Ereignisse für die angegebene Ereignisquelle.
Dispose()	Gibt die von der aktuellen Instanz der EventListener Klasse verwendeten Ressourcen frei.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Aktiviert Ereignisse für die angegebene Ereignisquelle mit der angegebenen Ausführlichkeitsebene oder niedriger, übereinstimmenden Ereignisstichwortkennzeichnung und übereinstimmenden Argumenten.
EnableEvents(EventSource, EventLevel, EventKeywords)	Aktiviert Ereignisse für die angegebene Ereignisquelle mit der angegebenen Ausführlichkeitsebene oder niedriger sowie übereinstimmenden Schlüsselwortkennzeichnungen.
EnableEvents(EventSource, EventLevel)	Aktiviert Ereignisse für die angegebene Ereignisquelle mit der angegebenen Ausführlichkeitsebene oder niedriger.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
EventSourceIndex(EventSource)	Ruft eine kleine nicht negative Zahl, die die angegebene Ereignisquelle darstellt.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnEventSourceCreated(EventSource)	Wird für alle vorhandenen Ereignisquellen aufgerufen, wenn der Ereignislistener erstellt wird und eine neue Ereignisquelle an den 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

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