EventListener EventListener EventListener EventListener Class

Definición

Proporciona métodos para habilitar y deshabilitar eventos de orígenes de eventos.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
Herencia
EventListenerEventListenerEventListenerEventListener
Implementaciones

Comentarios

Un agente de escucha de eventos representa el destino de todos los eventos generadosEventSource por las implementaciones de origen de eventos (objeto) en el dominio de aplicación actual.An event listener represents the target for all events generated by event source (EventSource object) implementations in the current application domain. Cuando se crea un nuevo agente de escucha de eventos, se adjunta lógicamente a todos los orígenes de eventos de ese dominio de aplicación.When a new event listener is created, it is logically attached to all event sources in that application domain.

Nota

Este tipo implementa la interfaz IDisposable.This type implements the IDisposable interface. Cuando haya terminado de utilizar el tipo, debe desecharlo directa o indirectamente.When you have finished using the type, you must dispose of it either directly or indirectly. Para eliminar el tipo directamente, llame a su método Dispose en un bloque try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Para deshacerse de él indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Para más información, vea la sección "Uso de objetos que implementan IDisposable" en el tema de la interfaz IDisposable.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Un agente de escucha de eventos puede habilitar o deshabilitar en base a un origen de eventos por día medianteEventLevelel uso de niveles deEventKeywordseventos () y palabras clave de eventos () para restringir aún más el conjunto de eventos que se van a enviar al agente de escucha.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. El agente de escucha también puede enviar comandos arbitrarios a un origen de eventos específico actual SendCommand mediante el método.The listener can also send arbitrary commands to a specific current event source by using the SendCommand method. Los significados de los comandos son específicos de la implementación del origen del evento.The meanings of the commands are specific to the implementation of the event source.

Si la Guid propiedad EventSource del objeto que se usa para habilitar o deshabilitar eventos es Empty, se verán afectados todos los orígenes de eventos del dominio de aplicación.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.

Se pueden definir varios agentes de escucha de eventos en un dominio de aplicación único.Multiple event listeners can be defined in a single application domain. Cada agente de escucha es lógicamente independiente de los demás agentes de escucha, de modo que los eventos que están habilitados o deshabilitados por un agente de escucha solo afectan a ese agente de escucha.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 posible que los comandos enviados con el SendCommand método realicen una operación semántica (como una recolección de elementos no utilizados o datos de vaciado) que afecte a los demás agentes de escucha, pero esta es la excepción en lugar de la regla.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.

Cada origen de eventos mantiene una lista de agentes de escucha de eventos a los que envía eventos.Each event source keeps a list of event listeners that it sends events to. Un conjunto de criterios de filtrado está asociado a cada par de agente de escucha de origen de eventos.A set of filtering criteria is associated with each event source-listener pair. Estos criterios determinan los eventos que recibirá el agente de escucha para el origen de eventos actual.These criteria determine the events that listener will receive for the current event source. Los agentes de escucha reciben los eventos OnEventWritten de su método.Listeners receive the events on their OnEventWritten method. Por lo tanto, las subclases de EventListener deben invalidar este método para hacer algo útil con los datos.Therefore, subclasses of EventListener must override this method to do something useful with the data.

Cuando se crea un nuevo origen de eventos, OnEventSourceCreated se llama al método.When a new event source is created, the OnEventSourceCreated method is called. Cada agente de escucha de eventos actual obtiene OnEventSourceCreated exactamente una llamada para cada origen de eventos actual que pueda enviar mensajes de registro.Every current event listener gets exactly one OnEventSourceCreated call for every current event source that can send it log messages. Cuando se crea un agente de escucha de eventos, se OnEventSourceCreated realiza una serie de llamadas para notificar al nuevo agente de escucha de todos los orígenes de eventos que existían antes de que se creara el agente de escucha.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.

Constructores

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

Crea una nueva instancia de la clase EventListener.Creates a new instance of the EventListener class.

Métodos

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

Deshabilita todos los eventos del origen de eventos especificado.Disables all events for the specified event source.

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

Libera los recursos utilizados por la instancia actual de la clase EventListener.Releases the resources used by the current instance of the EventListener class.

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

Habilita los eventos del origen de eventos especificado que tiene el nivel de detalle especificado o inferior.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)

Habilita los eventos del origen de eventos especificado que tiene el nivel de detalle especificado o inferior, y los marcadores de palabras clave coincidentes.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>)

Habilita los eventos del origen de eventos especificado que tiene el nivel de detalle especificado o inferior, el marcador de palabra clave de evento correspondiente, y los argumentos coincidentes.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)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Obtiene un pequeño número no negativo que representa el origen de eventos especificado.Gets a small non-negative number that represents the specified event source.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Llamado para todos los orígenes de eventos existentes cuando se crea el agente de escucha de eventos y cuando un nuevo origen de evento se asocia al agente de escucha.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)

Se llama siempre que un evento ha sido escrito por un origen de eventos para el que el agente de escucha de eventos ha habilitado los eventos.Called whenever an event has been written by an event source for which the event listener has enabled events.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Eventos

EventSourceCreated EventSourceCreated EventSourceCreated EventSourceCreated

Se produce cuando un origen de eventos (objeto EventSource) se adjunta al distribuidor.Occurs when an event source (EventSource object) is attached to the dispatcher.

EventWritten EventWritten EventWritten EventWritten

Se produce cuando un evento ha sido escrito por un origen de eventos (objeto EventSource) para el que el agente de escucha de eventos ha habilitado los eventos.Occurs when an event has been written by an event source (EventSource object) for which the event listener has enabled events.

Se aplica a