EventListener Classe

Definizione

Fornisce metodi per abilitare e disabilitare gli eventi dalle origini di eventi.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
Ereditarietà
EventListener
Implementazioni

Commenti

Un listener di eventi rappresenta la destinazione per tutti gli eventi generati dalle implementazioni dell'origine evento (EventSource oggetto) nel dominio applicazione corrente.An event listener represents the target for all events generated by event source (EventSource object) implementations in the current application domain. Quando viene creato un nuovo listener di eventi, questo viene collegato logicamente a tutte le origini eventi in tale dominio applicazione.When a new event listener is created, it is logically attached to all event sources in that application domain.

Nota

Il tipo implementa l'interfaccia IDisposable.This type implements the IDisposable interface. Una volta terminato l'utilizzo del tipo, è necessario eliminarlo direttamente o indirettamente.When you have finished using the type, you must dispose of it either directly or indirectly. Per eliminare direttamente il tipo, chiamare il metodo Dispose in un blocco try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Per eliminarlo indirettamente, utilizzare un costrutto di linguaggio come ad esempio using in C# o Using in Visual Basic.To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Per altre informazioni, vedere la sezione "Uso di un oggetto che implementa IDisposable" nell'argomento relativo all'interfaccia IDisposable.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Un listener di eventi può abilitare o disabilitare in base all'origine evento ogni volta usando i livelli evento (EventLevel) e le parole chiaveEventKeywordsdell'evento () per limitare ulteriormente il set di eventi da inviare al listener.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. Il listener può anche inviare comandi arbitrari a un'origine evento corrente specifica usando il SendCommand metodo.The listener can also send arbitrary commands to a specific current event source by using the SendCommand method. I significati dei comandi sono specifici dell'implementazione dell'origine evento.The meanings of the commands are specific to the implementation of the event source.

Se la Guid proprietà EventSource nell'oggetto utilizzato per abilitare o disabilitare gli eventi è Empty, verranno interessate tutte le origini eventi del dominio dell'applicazione.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.

È possibile definire più listener di eventi in un singolo dominio applicazione.Multiple event listeners can be defined in a single application domain. Ogni listener è logicamente indipendente dagli altri listener in modo che gli eventi abilitati o disabilitati da un listener abbiano effetto solo sul listener.Each listener is logically independent of the other listeners so that events that are enabled or disabled by one listener affect only that listener. È possibile che i comandi inviati con il SendCommand metodo eseguano un'operazione semantica, ad esempio un Garbage Collection o lo scaricamento di dati, che influisca sugli altri listener, ma si tratta dell'eccezione anziché della regola.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.

Ogni origine evento mantiene un elenco di listener di eventi a cui vengono inviati gli eventi.Each event source keeps a list of event listeners that it sends events to. Un set di criteri di filtro è associato a ogni coppia di listener di origine evento.A set of filtering criteria is associated with each event source-listener pair. Questi criteri determinano gli eventi che il listener riceverà per l'origine evento corrente.These criteria determine the events that listener will receive for the current event source. I listener ricevono gli eventi sul relativo OnEventWritten metodo.Listeners receive the events on their OnEventWritten method. Pertanto, le sottoclassi di EventListener devono eseguire l'override di questo metodo per eseguire un'operazione utile con i dati.Therefore, subclasses of EventListener must override this method to do something useful with the data.

Quando viene creata una nuova origine evento, viene OnEventSourceCreated chiamato il metodo.When a new event source is created, the OnEventSourceCreated method is called. Ogni listener di eventi corrente ottiene esattamente OnEventSourceCreated una chiamata per ogni origine evento corrente che può inviare i messaggi di log.Every current event listener gets exactly one OnEventSourceCreated call for every current event source that can send it log messages. Quando viene creato un listener di eventi, viene eseguita OnEventSourceCreated una serie di chiamate per notificare al nuovo listener di tutte le origini eventi esistenti prima della creazione del listener.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.

Costruttori

EventListener()

Crea una nuova istanza della classe EventListener.Creates a new instance of the EventListener class.

Metodi

DisableEvents(EventSource)

Disabilita tutti gli eventi per l'origine evento specificata.Disables all events for the specified event source.

Dispose()

Rilascia le risorse usate dall'istanza corrente della classe EventListener.Releases the resources used by the current instance of the EventListener class.

EnableEvents(EventSource, EventLevel)

Abilita gli eventi per l'origine evento specificato con il livello di dettaglio specificato o un livello inferiore.Enables events for the specified event source that has the specified verbosity level or lower.

EnableEvents(EventSource, EventLevel, EventKeywords)

Abilita gli eventi per l'origine evento specificato con il livello di dettaglio specificato o un livello inferiore e i flag di parole chiave corrispondenti.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>)

Abilita gli eventi per l'origine evento specificato con il livello di dettaglio specificato o un livello inferiore, i flag di parole chiave evento corrispondenti e gli argomenti corrispondenti.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 l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
EventSourceIndex(EventSource)

Ottiene un numero ridotto non negativo che rappresenta l'origine evento specificata.Gets a small non-negative number that represents the specified event source.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnEventSourceCreated(EventSource)

Chiamato per tutte le origini eventi esistenti quando viene creato il listener di eventi e una nuova origine evento viene associata al listener.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)

Chiamato ogni volta che un evento è stato scritto da un'origine evento per la quale il listener di eventi ha abilitato gli eventi.Called whenever an event has been written by an event source for which the event listener has enabled events.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Eventi

EventSourceCreated

Si verifica quando un'origine eventi (oggetto EventSource) è connessa al dispatcher.Occurs when an event source (EventSource object) is attached to the dispatcher.

EventWritten

Si verifica ogni volta che un evento è stato scritto da un'origine evento (oggetto EventSource) per la quale il listener di eventi ha abilitato gli eventi.Occurs when an event has been written by an event source (EventSource object) for which the event listener has enabled events.

Si applica a