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, die von der Ereignisquelle generiert (EventSource Objekt)-Implementierungen in der aktuellen Anwendungsdomäne.An event listener represents the target for all events generated by event source (EventSource object) implementations in the current application domain. Wenn ein neuer Event-Listener erstellt wird, ist es logisch alle Ereignisquellen in dieser Anwendungsdomäne zugewiesen.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 mit dem Typ haben, müssen Sie es entweder direkt oder indirekt freigeben.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 aktivieren oder deaktivieren Sie pro Quelle pro-Current-Ereignis, mithilfe von Ereignisebenen (EventLevel) und Ereignis-Schlüsselwörter (EventKeywords), um den Satz von Ereignissen an den Listener gesendet werden 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 Ereignisquelle der aktuellen senden, mit der SendCommand Methode.The listener can also send arbitrary commands to a specific current event source by using the SendCommand method. Die Bedeutung der Befehle sind spezifisch für die Implementierung der Ereignisquelle.The meanings of the commands are specific to the implementation of the event source.

Wenn die Guid -Eigenschaft in der EventSource Objekt, das zum Aktivieren oder Deaktivieren von Ereignissen verwendet wird, ist Empty, alle Ereignisquellen in der Anwendungsdomäne beeinträchtigt werden.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 der andere Listener, sodass Ereignisse, die aktiviert oder deaktiviert werden, indem Sie einen Listener sind nur für diesen Listener auswirken.Each listener is logically independent of the other listeners so that events that are enabled or disabled by one listener affect only that listener. Es ist möglich, dass Befehle, die gesendet werden, mit der SendCommand Methode, um einem semantische-Vorgang (z. B. eine Garbagecollection oder leeren Daten) ausführen, wirkt sich auf die anderen Listener, aber dies ist die Regel, statt die Ausnahme.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 Ereignisquelle behält eine Liste der Ereignislistener, denen Ereignisse gesendet werden.Each event source keeps a list of event listeners that it sends events to. Ein Satz von Filterkriterien ist mit jedem Ereignis quelllistener Paar verknüpft.A set of filtering criteria is associated with each event source-listener pair. Diese Kriterien bestimmen die Ereignisse für die aktuelle Ereignisquelle diesen Listener erhalten.These criteria determine the events that listener will receive for the current event source. Listener, die die Ereignisse empfangen, auf deren OnEventWritten Methode.Listeners receive the events on their OnEventWritten method. Aus diesem Grund Unterklassen von EventListener müssen überschreiben diese Methode, um etwas Sinnvolles mit den Daten tun.Therefore, subclasses of EventListener must override this method to do something useful with the data.

Wenn eine neue Ereignisquelle erstellt wird, die OnEventSourceCreated Methode wird aufgerufen.When a new event source is created, the OnEventSourceCreated method is called. Alle aktuellen Ereignislistener ruft genau eine OnEventSourceCreated rufen Sie für jede aktuelle Ereignisquelle, die sie senden können Protokollieren von Meldungen.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, eine Reihe von OnEventSourceCreated Aufrufe werden ausgeführt, um den neuen Listener alle Ereignisquellen 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: