EventListener Classe

Definição

Namespace:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Origem:

EventSource.cs

Fornece métodos para habilitar e desabilitar eventos de origens do evento.

public ref class EventListener abstract : IDisposable

public abstract class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Herança

Object

EventListener

Implementações

IDisposable

Comentários

Um ouvinte de eventos representa o destino para todos os eventos gerados por implementações de origem do evento (EventSource objeto) no domínio do aplicativo atual. Quando um novo ouvinte de eventos é criado, ele é logicamente anexado a todas as fontes de evento nesse domínio de aplicativo.

Observação

Esse tipo implementa a interface IDisposable. Quando terminar de usar o tipo, você deverá descartá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame o método Dispose dele em um bloco try/catch. Para descartá-lo indiretamente, use um constructo de linguagem como using ( em C#) ou Using (em Visual Basic). Saiba mais na seção "Como usar um objeto que implementa IDisposable" no tópico da interface IDisposable.

Um ouvinte de eventos pode habilitar ou desabilitar em uma base de origem de evento por atual usando níveis de evento (EventLevel) e palavras-chave de evento (EventKeywords) para restringir ainda mais o conjunto de eventos a serem enviados ao ouvinte. O ouvinte também pode enviar comandos arbitrários para uma fonte de evento atual específica usando o SendCommand método . Os significados dos comandos são específicos para a implementação da origem do evento.

Vários ouvintes de eventos podem ser definidos em um único domínio de aplicativo. Cada ouvinte é logicamente independente dos outros ouvintes para que os eventos habilitados ou desabilitados por um ouvinte afetem apenas esse ouvinte. É possível que os comandos enviados com o SendCommand método façam uma operação semântica (como uma coleta de lixo ou liberação de dados) que afeta os outros ouvintes, mas essa é a exceção em vez da regra.

Cada fonte de evento mantém uma lista de ouvintes de eventos para os quais envia eventos. Um conjunto de critérios de filtragem está associado a cada par de ouvintes de origem do evento. Esses critérios determinam os eventos que o ouvinte receberá para a origem do evento atual. Os ouvintes recebem os eventos em seu OnEventWritten método. Portanto, as subclasses de EventListener devem substituir esse método para fazer algo útil com os dados.

Quando uma nova fonte de evento é criada, o OnEventSourceCreated método é chamado. Cada ouvinte de eventos atual recebe exatamente uma OnEventSourceCreated chamada para cada fonte de evento atual que pode enviar mensagens de log. Quando um ouvinte de eventos é criado, uma série de OnEventSourceCreated chamadas são feitas para notificar o novo ouvinte de todas as fontes de evento que existiam antes da criação do ouvinte.

Importante

Ao instanciar um EventListener, os retornos de chamada para OnEventSourceCreated e OnEventWritten podem acontecer antes que o construtor seja concluído. Tome cuidado ao inicializar os membros da instância usados nesses retornos de chamada.

Construtores

EventListener()

Cria uma nova instância da classe EventListener.

Métodos

DisableEvents(EventSource)	Desabilita todos os eventos para a origem do evento especificada.
Dispose()	Libera os recursos usados pela instância atual da classe EventListener.
EnableEvents(EventSource, EventLevel)	Habilita eventos para a origem do evento especificado que têm o nível de detalhes especificado ou inferior.
EnableEvents(EventSource, EventLevel, EventKeywords)	Habilita eventos para a origem do evento especificado que têm o nível de detalhes especificado ou inferior e os sinalizadores de palavra-chave de correspondência.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Habilita eventos para a origem do evento especificada que têm o nível de detalhes especificado ou inferior e os sinalizadores de palavra-chave e argumentos correspondentes.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
EventSourceIndex(EventSource)	Obtém um pequeno número não negativo que representa a origem do evento especificada.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnEventSourceCreated(EventSource)	Chamado para todas as origens do evento existentes quando o ouvinte do evento é criado e quando uma nova origem do evento é anexada ao ouvinte.
OnEventWritten(EventWrittenEventArgs)	Chamado sempre que um evento tiver sido gravado por uma origem do evento para a qual o ouvinte de eventos tiver habilitado eventos.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Eventos

EventSourceCreated	Ocorre quando uma fonte do evento (objeto EventSource) está anexado ao dispatcher.
EventWritten	Ocorre quando um evento foi gravado por uma origem do evento (objeto EventSource) para a qual o ouvinte de eventos habilitou eventos.