EventListener EventListener EventListener EventListener Class

Definition

Stellt Methoden zum Aktivieren und Deaktivieren von Ereignissen aus Ereignisquellen bereit.Provides methods for enabling and disabling events from event sources.

public ref class EventListener abstract : IDisposable
public abstract class EventListener : IDisposable
type EventListener = class
    interface IDisposable
Public MustInherit Class EventListener
Implements IDisposable
Vererbung
EventListenerEventListenerEventListenerEventListener
Implementiert

Hinweise

Ein Ereignislistener stellt das Ziel für alle Ereignisse dar, die vonEventSource den Implementierungen der Ereignis Quelle (Object) in der aktuellen Anwendungsdomäne generiert werden.An event listener represents the target for all events generated by event source (EventSource object) implementations in the current application domain. Wenn ein neuer Ereignislistener erstellt wird, wird er logisch an alle Ereignis Quellen in dieser Anwendungsdomäne angefügt.When a new event listener is created, it is logically attached to all event sources in that application domain.

Hinweis

Dieser Typ implementiert die IDisposable-Schnittstelle.This type implements the IDisposable interface. Wenn Sie die Verwendung des Typs abgeschlossen haben, müssen Sie ihn entweder direkt oder indirekt verwerfen.When you have finished using the type, you must dispose of it either directly or indirectly. Zum direkten Löschen des Typs rufen Sie seine Dispose-Methode in einem try/catch-Block auf.To dispose of the type directly, call its Dispose method in a try/catch block. Zum indirekten Löschen verwenden Sie ein Sprachkonstrukt wie using (in C#) oder Using (in Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt „Verwenden eines Objekts, das IDisposable implementiert“ des Themas „Die IDisposable-Schnittstelle“.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Ein Ereignislistener kann auf Grundlage der aktuellen Ereignis Quelle aktivieren oder deaktivieren, indem er EreignisEventLevelEbenen () und EreignisEventKeywordsSchlüsselwörter () verwendet, um den Satz von Ereignissen, die an den Listener gesendet werden sollen, weiter einzuschränken.An event listener can enable or disable on a per-current event source basis by using event levels (EventLevel) and event keywords (EventKeywords) to further restrict the set of events to be sent to the listener. Der Listener kann auch beliebige Befehle an eine bestimmte aktuelle Ereignis Quelle senden, indem er SendCommand die-Methode verwendet.The listener can also send arbitrary commands to a specific current event source by using the SendCommand method. Die Bedeutungen der Befehle sind spezifisch für die Implementierung der Ereignis Quelle.The meanings of the commands are specific to the implementation of the event source.

Wenn die Guid -Eigenschaft EventSource im-Objekt, das verwendet wird, um Ereignisse zu Emptyaktivieren oder zu deaktivieren, den Wert hat, sind alle Ereignis Quellen in der Anwendungsdomäne betroffen.If the Guid property in the EventSource object that is used to enable or disable events is Empty, all event sources in the application domain are affected.

Mehrere Ereignislistener können in einer einzelnen Anwendungsdomäne definiert werden.Multiple event listeners can be defined in a single application domain. Jeder Listener ist logisch unabhängig von den anderen Listenern, sodass Ereignisse, die von einem Listener aktiviert oder deaktiviert werden, nur diesen Listener betreffen.Each listener is logically independent of the other listeners so that events that are enabled or disabled by one listener affect only that listener. Befehle, die mit der SendCommand -Methode gesendet werden, können einen semantischen Vorgang ausführen (z. b. ein Garbage Collection oder das Leeren von Daten), der sich auf die anderen Listener auswirkt, aber dies ist die Ausnahme und nicht die Regel.It is possible for commands sent with the SendCommand method to do a semantic operation (such as a garbage collection or flushing data) that affects the other listeners, but this is the exception rather than the rule.

Jede Ereignis Quelle speichert eine Liste von Ereignislistenern, an die Ereignisse gesendet werden.Each event source keeps a list of event listeners that it sends events to. Jedem ereignisquellenlistener-Paar ist ein Satz von Filterkriterien zugeordnet.A set of filtering criteria is associated with each event source-listener pair. Mit diesen Kriterien werden die Ereignisse bestimmt, die der Listener für die aktuelle Ereignis Quelle empfängt.These criteria determine the events that listener will receive for the current event source. Listener empfangen die Ereignisse für Ihre OnEventWritten -Methode.Listeners receive the events on their OnEventWritten method. Daher müssen Unterklassen von EventListener diese Methode überschreiben, damit Sie für die Daten etwas Nützliches ist.Therefore, subclasses of EventListener must override this method to do something useful with the data.

Wenn eine neue Ereignis Quelle erstellt wird, wird OnEventSourceCreated die-Methode aufgerufen.When a new event source is created, the OnEventSourceCreated method is called. Jeder aktuelle Ereignislistener ruft genau OnEventSourceCreated einen-Befehl für jede aktuelle Ereignis Quelle ab, die IT-Protokollmeldungen senden kann.Every current event listener gets exactly one OnEventSourceCreated call for every current event source that can send it log messages. Wenn ein Ereignislistener erstellt wird, OnEventSourceCreated wird eine Reihe von Aufrufen durchgeführt, um den neuen Listener für alle Ereignis Quellen zu benachrichtigen, die vorhanden waren, bevor der Listener erstellt wurde.When an event listener is created, a series of OnEventSourceCreated calls are made to notify the new listener of all the event sources that existed before the listener was created.

Konstruktoren

EventListener() EventListener() EventListener() EventListener()

Erstellt eine neue Instanz der EventListener-Klasse.Creates a new instance of the EventListener class.

Methoden

DisableEvents(EventSource) DisableEvents(EventSource) DisableEvents(EventSource) DisableEvents(EventSource)

Deaktiviert alle Ereignisse für die angegebene Ereignisquelle.Disables all events for the specified event source.

Dispose() Dispose() Dispose() Dispose()

Gibt alle von der aktuellen Instanz der EventListener-Klasse verwendeten Ressourcen frei.Releases the resources used by the current instance of the EventListener class.

EnableEvents(EventSource, EventLevel) EnableEvents(EventSource, EventLevel) EnableEvents(EventSource, EventLevel) EnableEvents(EventSource, EventLevel)

Aktiviert Ereignisse für die angegebene Ereignisquelle, die die angegebene Ausführlichkeitsgrad oder niedriger aufweist.Enables events for the specified event source that has the specified verbosity level or lower.

EnableEvents(EventSource, EventLevel, EventKeywords) EnableEvents(EventSource, EventLevel, EventKeywords) EnableEvents(EventSource, EventLevel, EventKeywords) 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.Enables events for the specified event source that has the specified verbosity level or lower, and matching keyword flags.

EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>) EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>) EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>) 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.Enables events for the specified event source that has the specified verbosity level or lower, matching event keyword flag, and matching arguments.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
EventSourceIndex(EventSource) EventSourceIndex(EventSource) EventSourceIndex(EventSource) EventSourceIndex(EventSource)

Ruft eine kleine nicht negative Zahl ab, die die angegebene Ereignisquelle darstellt.Gets a small non-negative number that represents the specified event source.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnEventSourceCreated(EventSource) OnEventSourceCreated(EventSource) OnEventSourceCreated(EventSource) OnEventSourceCreated(EventSource)

Wird für alle vorhandenen Ereignisquellen aufgerufen, wenn der Ereignislistener erstellt wird, und wenn eine neue Ereignisquelle zum Listener angefügt wird.Called for all existing event sources when the event listener is created and when a new event source is attached to the listener.

OnEventWritten(EventWrittenEventArgs) OnEventWritten(EventWrittenEventArgs) OnEventWritten(EventWrittenEventArgs) OnEventWritten(EventWrittenEventArgs)

Wird aufgerufen, wenn ein Ereignis von einer Ereignisquelle geschrieben wurde, für die der Ereignislistener Ereignisse aktiviert hat.Called whenever an event has been written by an event source for which the event listener has enabled events.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Ereignisse

EventSourceCreated EventSourceCreated EventSourceCreated EventSourceCreated

Tritt auf, wenn eine Ereignisquelle (EventSource-Objekt) an den Verteiler angefügt ist.Occurs when an event source (EventSource object) is attached to the dispatcher.

EventWritten EventWritten EventWritten EventWritten

Tritt auf, wenn ein Ereignis von einer Ereignisquelle (EventSource-Objekt) geschrieben wurde, für die der Ereignislistener Ereignisse aktiviert hat.Occurs when an event has been written by an event source (EventSource object) for which the event listener has enabled events.

Gilt für: