EventListener Klasse

Definition

Namespace:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

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

public ref class EventListener abstract : IDisposable

public ref class EventListener : IDisposable

public abstract class EventListener : IDisposable

public class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements 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.

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 einer aktuellen Ereignisquelle basierend auf Ereignisebenen () und EreignisstichwörternEventLevel (EventKeywords) aktivieren oder deaktivieren, um den Satz von Ereignissen, die an den Listener gesendet werden sollen, weiter einzuschränken. 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 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 Befehle, die mit der SendCommand Methode gesendet werden, eine semantische Operation (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 behält eine Liste von Ereignislistenern bei, an die ereignisse gesendet werden. Jeder Ereignisquellenlistenerpaar ist eine Reihe von Filterkriterien zugeordnet. Diese Kriterien bestimmen die Ereignisse, die listener für die aktuelle Ereignisquelle empfangen. Listener erhalten die Ereignisse auf ihrer OnEventWritten Methode. Daher müssen Unterklassen dieser EventListener Methode außer Kraft setzen, um etwas nützliches mit den Daten 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 es 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 vorhanden waren, bevor der Listener erstellt wurde.

Wichtig

Beim Instanziieren einer EventListenerInstanziierung können die Rückrufe OnEventSourceCreated erfolgen und OnEventWritten erfolgen, bevor der Konstruktor abgeschlossen ist. Achten Sie darauf, wenn Sie Instanzmitglieder 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.