EventListener Classe

Definizione

Spazio dei nomi:

System.Diagnostics.Tracing

Assembly:

netstandard.dll, System.Diagnostics.Tracing.dll

Origine:

EventSource.cs

Fornisce metodi per abilitare e disabilitare eventi da origini eventi.

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 applicazione corrente. Quando viene creato un nuovo listener di eventi, viene collegato logicamente a tutte le origini eventi nel dominio applicazione.

Note

Questo tipo implementa l'interfaccia IDisposable . Al termine dell'uso del tipo, è necessario eliminarlo direttamente o indirettamente. Per eliminare direttamente il tipo, chiamare il Dispose relativo metodo in un try/catch blocco. Per eliminarlo indirettamente, usare un costrutto del linguaggio, ad using esempio (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 per ogni origine evento corrente 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 di 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 eseseguono un'operazione semantica ,ad esempio un'operazione di Garbage Collection o lo scaricamento dei dati, che influiscono sugli altri listener, ma si tratta dell'eccezione anziché della 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 relativo 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 di eventi corrente riceve esattamente una OnEventSourceCreated chiamata per ogni origine evento corrente che può inviare messaggi di log. Quando viene creato un listener di 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 , EventListeneril callback a OnEventSourceCreated e OnEventWritten può verificarsi prima del completamento del costruttore. Prestare attenzione quando si inizializzano i membri dell'istanza usati in tali callback.

Costruttori

Nome	Descrizione
EventListener()	Crea una nuova istanza della EventListener classe .

Metodi

Nome	Descrizione
DisableEvents(EventSource)	Disabilita tutti gli eventi per l'origine evento specificata.
Dispose()	Rilascia le risorse usate dall'istanza corrente della EventListener classe .
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Abilita gli eventi per l'origine evento specificata con il livello di dettaglio specificato o inferiore, il flag di parola chiave dell'evento corrispondente e gli argomenti corrispondenti.
EnableEvents(EventSource, EventLevel, EventKeywords)	Abilita gli eventi per l'origine evento specificata con il livello di dettaglio specificato o inferiore e i flag di parole chiave corrispondenti.
EnableEvents(EventSource, EventLevel)	Abilita gli eventi per l'origine evento specificata con il livello di dettaglio specificato o inferiore.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
EventSourceIndex(EventSource)	Ottiene un numero piccolo non negativo che rappresenta l'origine evento specificata.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnEventSourceCreated(EventSource)	Viene chiamato per tutte le origini eventi esistenti quando viene creato il listener di eventi e quando viene collegata una nuova origine evento al listener.
OnEventWritten(EventWrittenEventArgs)	Chiamato ogni volta che un evento è stato scritto da un'origine evento per cui il listener di eventi ha abilitato gli eventi.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

Nome	Descrizione
EventSourceCreated	Si verifica quando un'origine evento (EventSource oggetto ) è collegata al dispatcher.
EventWritten	Si verifica quando un evento è stato scritto da un'origine evento (EventSource oggetto ) per cui il listener di eventi ha abilitato gli eventi.