EventListener Classe

Definição

Espaço de Nomes:
System.Diagnostics.Tracing
Assemblagens:
mscorlib.dll, System.Diagnostics.Tracing.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Diagnostics.Tracing.dll
Assemblagem:
netstandard.dll

Fornece métodos para ativar e desativar eventos provenientes das fontes de eventos.

public ref class EventListener abstract : IDisposable
public ref class EventListener : IDisposable
public abstract class EventListener : IDisposable
public class EventListener : IDisposable
type EventListener = class
    interface IDisposable
Public MustInherit Class EventListener
Implements IDisposable
Public Class EventListener
Implements IDisposable
Herança
Object
EventListener
Implementações
IDisposable

Observações

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

Note

Este tipo implementa a interface IDisposable. Quando terminar de usar o tipo, deve descartá-lo, direta ou indiretamente. Para descartar o tipo diretamente, chame seu método Dispose em um bloco try/catch. Para descartá-lo indiretamente, use uma construção de linguagem como using (em C#) ou Using (em Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa IDisposable" no tópico da IDisposable interface.

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

Múltiplos ouvintes de eventos podem ser definidos num único domínio de aplicação. Cada ouvinte é logicamente independente dos outros ouvintes, de modo que eventos que são ativados ou desativados por um ouvinte afetam apenas esse ouvinte. É possível que comandos enviados com o SendCommand método façam uma operação semântica (como uma recolha de lixo ou limpeza de dados) que afeta os outros ouvintes, mas isto é a exceção e não a regra.

Cada fonte de evento mantém uma lista de ouvintes de eventos a quem envia eventos. Um conjunto de critérios de filtragem está associado a cada par fonte-ouvinte de eventos. Estes critérios determinam os eventos que o ouvinte receberá para a fonte atual do evento. Os ouvintes recebem os acontecimentos do seu OnEventWritten caminho. Portanto, subclasses de EventListener devem sobrepor este método para fazer algo útil com os dados.

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

Importante

Ao instanciar um EventListener, as chamadas para OnEventSourceCreated e OnEventWritten podem ocorrer antes de o construtor ter concluído. Tenha cuidado ao inicializar os membros da instância usados nessas callbacks.

Construtores

Name Description
EventListener()

Cria uma nova instância da EventListener classe.

Métodos

Name Description
DisableEvents(EventSource)

Desativa todos os eventos para a fonte de eventos especificada.
Dispose()

Liberta os recursos usados pela instância atual da EventListener classe.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)

Permite eventos para a fonte de eventos especificada que tenha o nível de verbosidade especificado ou inferior, a flag de palavra-chave de evento correspondente e argumentos correspondentes.
EnableEvents(EventSource, EventLevel, EventKeywords)

Permite eventos para a fonte de eventos especificada que tenha o nível de verbosidade especificado ou inferior, e as bandeiras de palavras-chave correspondentes.
EnableEvents(EventSource, EventLevel)

Permite eventos para a fonte de eventos especificada que tenha o nível de verbosidade especificado ou inferior.
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 fonte do evento especificada.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnEventSourceCreated(EventSource)

Chamado para todas as fontes de eventos existentes quando o ouvinte de eventos é criado e quando uma nova fonte de eventos é associada ao ouvinte.
OnEventWritten(EventWrittenEventArgs)

Chamado sempre que um evento foi escrito por uma fonte de evento para a qual o ouvinte do evento ativou eventos.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

evento

Name Description
EventSourceCreated

Ocorre quando uma fonte de evento (EventSource objeto) está ligada ao despachante.
EventWritten

Ocorre quando um evento foi escrito por uma fonte de eventos (EventSource objeto) para a qual o ouvinte de eventos ativou eventos.

Aplica-se a