EventListener Clase

Definición

Espacio de nombres:

System.Diagnostics.Tracing

Ensamblado:

System.Diagnostics.Tracing.dll

Source:

EventSource.cs

Proporciona métodos para habilitar y deshabilitar eventos de orígenes de eventos.

public ref class EventListener abstract : IDisposable

public abstract class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Herencia

Object

EventListener

Implementaciones

IDisposable

Comentarios

Un agente de escucha de eventos representa el destino de todos los eventos generados por implementaciones de origen de eventos (EventSource objeto) en el dominio de aplicación actual. 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.

Nota

Este tipo implementa la interfaz IDisposable. Cuando haya terminado de usar el tipo, debe eliminarlo directa o indirectamente. Para eliminar el tipo directamente, llame a su método Dispose en un bloque try/catch. Para deshacerse de él indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para más información, vea la sección "Uso de objetos que implementan IDisposable" en el tema de la interfaz IDisposable.

Un agente de escucha de eventos puede habilitar o deshabilitar en cada origen de eventos actual mediante el uso de niveles de eventos () y palabras clave de evento (EventLevelEventKeywords) para restringir aún más el conjunto de eventos que se enviarán al agente de escucha. El agente de escucha también puede enviar comandos arbitrarios a un origen de eventos actual específico mediante el SendCommand método . Los significados de los comandos son específicos de la implementación del origen del evento.

Se pueden definir varios agentes de escucha de eventos en un único dominio de aplicación. Cada agente de escucha es lógicamente independiente de los demás agentes de escucha para que los eventos habilitados o deshabilitados por un agente de escucha afecten solo a ese agente de escucha. 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 afecten a los demás agentes de escucha, pero esta es la excepción en lugar de la regla.

Cada origen de eventos mantiene una lista de agentes de escucha de eventos a los que envía eventos. Un conjunto de criterios de filtrado está asociado a cada par de agente de escucha de origen de eventos. Estos criterios determinan los eventos que el agente de escucha recibirá para el origen del evento actual. Los agentes de escucha reciben los eventos en su OnEventWritten método. Por lo tanto, las subclases de EventListener deben invalidar este método para hacer algo útil con los datos.

Cuando se crea un nuevo origen de eventos, se llama al OnEventSourceCreated método . Cada agente de escucha de eventos actual obtiene exactamente una OnEventSourceCreated llamada para cada origen de eventos actual que puede enviar mensajes de registro. Cuando se crea un agente de escucha de eventos, se realiza una serie de OnEventSourceCreated llamadas para notificar al nuevo agente de escucha todos los orígenes de eventos que existían antes de crear el agente de escucha.

Importante

Al crear una instancia de , EventListenerlas devoluciones de llamada a OnEventSourceCreated y OnEventWritten se pueden producir antes de que se haya completado el constructor. Tenga cuidado al inicializar los miembros de instancia usados en esas devoluciones de llamada.

Constructores

EventListener()

Crea una nueva instancia de la clase EventListener.

Métodos

DisableEvents(EventSource)	Deshabilita todos los eventos del origen de eventos especificado.
Dispose()	Libera los recursos utilizados por la instancia actual de la clase EventListener.
EnableEvents(EventSource, EventLevel)	Habilita los eventos del origen de eventos especificado que tiene el nivel de detalle especificado o inferior.
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.
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.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
EventSourceIndex(EventSource)	Obtiene un pequeño número no negativo que representa el origen de eventos especificado.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
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.
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.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

EventSourceCreated	Se produce cuando un origen de eventos (objeto EventSource) se adjunta al distribuidor.
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.