EventListener Classe

Definizione

Spazio dei nomi:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Fornisce metodi per abilitare e disabilitare eventi da origini evento.

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

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.

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 per ogni origine evento corrente usando i livelli di evento () e le parole chiave di 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 gli 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 un'operazione utile 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 EventListenerdi , il 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

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.