EventListener Classe

Definizione

Spazio dei nomi:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Origine:

EventSource.cs

Fornisce metodi per abilitare e disabilitare eventi da origini evento.

public ref class EventListener abstract : IDisposable

public abstract class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Ereditarietà

Object

EventListener

Implementazioni

IDisposable

Commenti

Un listener di eventi rappresenta la destinazione per tutti gli eventi generati dalle implementazioni dell'origine evento (EventSource oggetto) nel dominio dell'applicazione corrente. Quando viene creato un nuovo listener eventi, viene collegato logicamente a tutte le origini eventi nel dominio dell'applicazione.

Nota

Il tipo implementa l'interfaccia IDisposable. Al termine dell'uso del tipo, è necessario eliminarlo direttamente o indirettamente. Per eliminare direttamente il tipo, chiamare il metodo Dispose in un blocco try/catch. Per eliminarlo indirettamente, utilizzare un costrutto di linguaggio come ad esempio using in C# o Using in Visual Basic. Per altre informazioni, vedere la sezione "Uso di un oggetto che implementa IDisposable" nell'argomento relativo all'interfaccia IDisposable.

Un listener di eventi può abilitare o disabilitare in base all'origine eventi per ogni origine evento usando i livelli di evento () e le parole chiave evento (EventLevelEventKeywords) per limitare ulteriormente il set di eventi da inviare al listener. Il listener può anche inviare comandi arbitrari a un'origine evento corrente specifica usando il SendCommand metodo . I significati dei comandi sono specifici dell'implementazione dell'origine evento.

È possibile definire più listener eventi in un singolo dominio applicazione. Ogni listener è logicamente indipendente dagli altri listener in modo che gli eventi abilitati o disabilitati da un listener influiscano solo sul listener. È possibile che i comandi inviati con il SendCommand metodo per eseguire un'operazione semantica (ad esempio un garbage collection o scaricare dati) che influiscono sugli altri listener, ma questa è l'eccezione anziché la regola.

Ogni origine evento mantiene un elenco di listener di eventi a cui invia eventi. Un set di criteri di filtro è associato a ogni coppia di listener di origine evento. Questi criteri determinano gli eventi che il listener riceverà per l'origine evento corrente. I listener ricevono gli eventi sul OnEventWritten metodo. Pertanto, le sottoclassi di devono eseguire l'override di EventListener questo metodo per eseguire operazioni utili con i dati.

Quando viene creata una nuova origine evento, viene chiamato il OnEventSourceCreated metodo . Ogni listener evento corrente ottiene esattamente una OnEventSourceCreated chiamata per ogni origine evento corrente che può inviare messaggi di log. Quando viene creato un listener eventi, viene effettuata una serie di OnEventSourceCreated chiamate per notificare al nuovo listener tutte le origini eventi esistenti prima della creazione del listener.

Importante

Quando si crea un'istanza di EventListener, i callback a OnEventSourceCreated e OnEventWritten possono verificarsi prima che il costruttore sia stato completato. Prestare attenzione quando si inizializzano i membri dell'istanza usati in tali callback.

Costruttori

EventListener()

Crea una nuova istanza della classe EventListener.

Metodi

DisableEvents(EventSource)	Disabilita tutti gli eventi per l'origine evento specificata.
Dispose()	Rilascia le risorse usate dall'istanza corrente della classe EventListener.
EnableEvents(EventSource, EventLevel)	Abilita gli eventi per l'origine evento specificata con il livello di dettaglio specificato o un livello inferiore.
EnableEvents(EventSource, EventLevel, EventKeywords)	Abilita gli eventi per l'origine evento specificata con il livello di dettaglio specificato o un livello inferiore e i flag di parole chiave corrispondenti.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Abilita gli eventi per l'origine evento specificata con il livello di dettaglio specificato o un livello inferiore, i flag di parole chiave evento corrispondenti e gli argomenti corrispondenti.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
EventSourceIndex(EventSource)	Ottiene un numero ridotto non negativo che rappresenta l'origine evento specificata.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnEventSourceCreated(EventSource)	Chiamato per tutte le origini evento esistenti quando viene creato il listener di eventi e una nuova origine evento viene associata al 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.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

EventSourceCreated	Si verifica quando un'origine eventi (oggetto EventSource) è connessa al 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.