EventListener Classe

Definição

Fornece métodos para habilitar e desabilitar eventos de fontes 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
Herança
EventListener
Implementações

Comentários

Um ouvinte de eventos representa o destino de todos os eventos gerados pelasEventSource implementações de origem (objeto) do evento no domínio do aplicativo atual.An event listener represents the target for all events generated by event source (EventSource object) implementations in the current application domain. Quando um novo ouvinte de eventos é criado, ele é logicamente anexado a todas as origens de evento nesse domínio de aplicativo.When a new event listener is created, it is logically attached to all event sources in that application domain.

Observação

Esse tipo implementa a interface IDisposable.This type implements the IDisposable interface. Quando você terminar de usar o tipo, deverá descartá-lo direta ou indiretamente.When you have finished using the type, you must dispose of it either directly or indirectly. Para descartar o tipo diretamente, chame o método Dispose dele em um bloco try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Para descartá-lo indiretamente, use um constructo de linguagem como using ( em C#) ou Using (em Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Saiba mais na seção "Como usar um objeto que implementa IDisposable" no tópico da interface IDisposable.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Um ouvinte de eventos pode habilitar ou desabilitar o em uma base de origem de evento por corrente usandoEventLevelos níveis de evento () eEventKeywordsas palavras-chave do evento () para restringir ainda mais o conjunto de eventos a serem enviados para o ouvinte.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. O ouvinte também pode enviar comandos arbitrários para uma origem específica do evento atual SendCommand usando o método.The listener can also send arbitrary commands to a specific current event source by using the SendCommand method. Os significados dos comandos são específicos para a implementação da origem do evento.The meanings of the commands are specific to the implementation of the event source.

Se a Guid propriedade EventSource no objeto usado para habilitar ou desabilitar eventos for Empty, todas as origens de evento no domínio do aplicativo serão afetadas.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.

Vários ouvintes de evento podem ser definidos em um único domínio de aplicativo.Multiple event listeners can be defined in a single application domain. Cada ouvinte é logicamente independente dos outros ouvintes, de modo que os eventos habilitados ou desabilitados por um ouvinte afetem apenas esse ouvinte.Each listener is logically independent of the other listeners so that events that are enabled or disabled by one listener affect only that listener. É possível que os comandos enviados com o SendCommand método realizem uma operação semântica (como uma coleta de lixo ou dados de liberação) que afetem os outros ouvintes, mas essa é a exceção em vez da regra.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 origem do evento mantém uma lista de ouvintes de eventos para os quais ele envia eventos.Each event source keeps a list of event listeners that it sends events to. Um conjunto de critérios de filtragem é associado a cada par de ouvinte de origem de evento.A set of filtering criteria is associated with each event source-listener pair. Esses critérios determinam os eventos que o ouvinte receberá para a origem do evento atual.These criteria determine the events that listener will receive for the current event source. Os ouvintes recebem os eventos em OnEventWritten seu método.Listeners receive the events on their OnEventWritten method. Portanto, as subclasses EventListener de devem substituir esse método para fazer algo útil com os dados.Therefore, subclasses of EventListener must override this method to do something useful with the data.

Quando uma nova origem do evento é criada, OnEventSourceCreated o método é chamado.When a new event source is created, the OnEventSourceCreated method is called. Cada ouvinte de evento atual Obtém OnEventSourceCreated exatamente uma chamada para cada fonte de evento atual que pode enviar mensagens de log de ti.Every current event listener gets exactly one OnEventSourceCreated call for every current event source that can send it log messages. Quando um ouvinte de eventos é criado, uma OnEventSourceCreated série de chamadas é feita para notificar o novo ouvinte de todas as fontes de eventos que existiam antes da criação do ouvinte.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.

Construtores

EventListener()

Cria uma nova instância da classe EventListener.Creates a new instance of the EventListener class.

Métodos

DisableEvents(EventSource)

Desabilita todos os eventos para a origem do evento especificada.Disables all events for the specified event source.

Dispose()

Libera os recursos usados pela instância atual da classe EventListener.Releases the resources used by the current instance of the EventListener class.

EnableEvents(EventSource, EventLevel)

Habilita eventos para a origem do evento especificado que têm o nível de detalhes especificado ou inferior.Enables events for the specified event source that has the specified verbosity level or lower.

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.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>)

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.Enables events for the specified event source that has the specified verbosity level or lower, matching event keyword flag, and matching arguments.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
EventSourceIndex(EventSource)

Obtém um pequeno número não negativo que representa a origem do evento especificada.Gets a small non-negative number that represents the specified event source.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(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.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)

Chamado sempre que um evento tiver sido gravado por uma origem do evento para a qual o ouvinte de eventos tiver habilitado eventos.Called whenever an event has been written by an event source for which the event listener has enabled events.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Eventos

EventSourceCreated

Ocorre quando uma fonte do evento (objeto EventSource) está anexado ao dispatcher.Occurs when an event source (EventSource object) is attached to the dispatcher.

EventWritten

Ocorre quando um evento foi gravado por uma origem do evento (objeto EventSource) para a qual o ouvinte de eventos habilitou eventos.Occurs when an event has been written by an event source (EventSource object) for which the event listener has enabled events.

Aplica-se a