Condividi tramite


EventProviderTraceListener Classe

Definizione

Listener per TraceSource che scrive eventi nel sottosistema ETW.

public ref class EventProviderTraceListener : System::Diagnostics::TraceListener
public class EventProviderTraceListener : System.Diagnostics.TraceListener
type EventProviderTraceListener = class
    inherit TraceListener
Public Class EventProviderTraceListener
Inherits TraceListener
Ereditarietà
EventProviderTraceListener

Esempio

private static Guid providerId = new Guid("{B3F0C8FC-E8A8-4868-8901-1465E8A2F41B}");  

    EventProviderTraceListener listener = new EventProviderTraceListener(providerId.ToString(), "Test Listener", "::");  

    // You should use the All default level and control the level using the  
    // ETW session; otherwise, you may not log all the events requested by the  
    // session.  
    TraceSource source = new TraceSource("MyProvider", SourceLevels.All);  

    source.Listeners.Add(listener);  

    source.TraceData(TraceEventType.Warning | TraceEventType.Start, 2, new object[] { "abc", "def", true, 123 });  

    source.TraceEvent(TraceEventType.Warning, 12, "Provider guid: {0}", new object[] { providerId });  

    source.TraceInformation("string {0}, bool {1}, int {2}, ushort {3}", new object[] { "abc", false, 123, (UInt32)5 });  

Commenti

Tutti i dati dell'evento (traccia o debug) dell'evento di origine vengono scritti nel sottosistema ETW come stringa. Gli elementi dati sono delimitati tramite una virgola. Per specificare un delimitatore diverso, utilizzare la Delimiter proprietà .

Aggiungendo il listener per System.Diagnostics.TraceSource registrare il provider con il sottosistema ETW. È necessario creare una sessione di traccia ETW usando il programma eseguibile Logman.exe (o qualcosa di simile) per scrivere gli eventi in un file di log.

Non è necessario un manifesto per utilizzare gli eventi dal listener perché i dati dell'evento sono una singola stringa.

Quando si chiamano i System.Diagnostics.TraceSource metodi per scrivere eventi, si passa un System.Diagnostics.TraceEventType valore di enumerazione. L'enumerazione contiene sia valori di livello che di parola chiave. Quando si abilita un provider del listener di traccia da una sessione ETW, il valore di livello specificato può essere il valore associato a uno dei valori di enumerazione seguenti System.Diagnostics.TraceEventType :

  • Critico (il valore è 1)

  • Errore (il valore è 2)

  • Informazioni (il valore è 8)

  • Dettagliato (il valore è 16)

  • Avviso (il valore è 4)

Il valore della parola chiave specificato per la sessione può essere il valore associato a uno dei valori di enumerazione seguenti System.Diagnostics.TraceEventType :

  • Resume (il valore è 2.048)

  • Inizio (il valore è 256)

  • Stop (il valore è 512)

  • Sospensione (il valore è 1.024)

  • Trasferimento (il valore è 4.096)

Costruttori

EventProviderTraceListener(String)

Inizializza una nuova istanza della classe EventProviderTraceListener con l'identificatore del provider specificato.

EventProviderTraceListener(String, String)

Inizializza una nuova istanza della classe EventProviderTraceListener utilizzando l'identificatore del provider specificato e il nome del listener.

EventProviderTraceListener(String, String, String)

Inizializza una nuova istanza della classe EventProviderTraceListener utilizzando l'identificatore del provider specificato, il nome del listener e il delimitatore.

Proprietà

Attributes

Ottiene gli attributi personalizzati del listener di traccia definiti nel file di configurazione dell'applicazione.

(Ereditato da TraceListener)
Delimiter

Ottiene o imposta il delimitatore usato per delimitare i dati dell'evento scritti nel sottosistema ETW.

Filter

Ottiene o imposta il filtro di traccia per il listener di traccia.

(Ereditato da TraceListener)
IndentLevel

Ottiene o imposta il livello di rientro.

(Ereditato da TraceListener)
IndentSize

Ottiene o imposta il numero di spazi in un rientro.

(Ereditato da TraceListener)
IsThreadSafe

Ottiene un valore che indica se il listener di traccia è thread-safe.

Name

Ottiene o imposta un nome per l'oggetto TraceListener.

(Ereditato da TraceListener)
NeedIndent

Ottiene o imposta un valore che indica se impostare il rientro dell'output.

(Ereditato da TraceListener)
TraceOutputOptions

Ottiene o imposta le opzioni dell'output di traccia.

(Ereditato da TraceListener)

Metodi

Close()

Chiude il flusso di output in modo da bloccare la ricezione dell'output di tracciatura o di debug.

CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da TraceListener.

(Ereditato da TraceListener)
Dispose(Boolean)

Rilascia le risorse non gestite usate da TraceListener e, facoltativamente, le risorse gestite.

(Ereditato da TraceListener)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
Fail(String)

Genera un messaggio di errore nel listener creato durante l'implementazione della classe TraceListener.

(Ereditato da TraceListener)
Fail(String, String)

Genera un messaggio di errore e un messaggio di errore dettagliato nel listener creato durante l'implementazione della classe TraceListener.

Flush()

Scarica il buffer di output.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetLifetimeService()
Obsoleti.

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.

(Ereditato da MarshalByRefObject)
GetSupportedAttributes()

Ottiene gli attributi personalizzati supportati dal listener di traccia.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
InitializeLifetimeService()
Obsoleti.

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.

(Ereditato da MarshalByRefObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Scrive le informazioni di traccia, un oggetto dati e le informazioni di evento nell'output specifico del listener.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Scrive le informazioni di traccia, un oggetto dati e le informazioni di evento nell'output specifico del listener.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Scrive le informazioni di traccia e di evento nell'output specifico del listener.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Scrive le informazioni di traccia, un messaggio e le informazioni di evento nell'output specifico del listener.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Scrive le informazioni di traccia, una matrice di oggetti formattata e le informazioni di evento nell'output specifico del listener.

TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Scrive le informazioni di traccia, un messaggio, l'identità di un'attività correlata e le informazioni di evento nell'output specifico del listener.

Write(Object)

Scrive il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener.

(Ereditato da TraceListener)
Write(Object, String)

Scrive un nome di categoria e il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener.

(Ereditato da TraceListener)
Write(String)

Quando se ne esegue l'override in una classe derivata, scrive il messaggio specificato nel listener creato nella classe derivata.

Write(String, String)

Scrive un nome di categoria e un messaggio nel listener creato durante l'implementazione della classe TraceListener.

(Ereditato da TraceListener)
WriteIndent()

Inserisce il rientro nel listener creato quando si implementa questa classe e reimposta la proprietà NeedIndent su false.

(Ereditato da TraceListener)
WriteLine(Object)

Scrive il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener, seguito da un terminatore di riga.

(Ereditato da TraceListener)
WriteLine(Object, String)

Scrive un nome di categoria e il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener, seguito da un terminatore di riga.

(Ereditato da TraceListener)
WriteLine(String)

Quando se ne esegue l'override in una classe derivata, scrive un messaggio nel listener creato nella classe derivata, seguito da un terminatore di riga.

WriteLine(String, String)

Scrive un nome di categoria e un messaggio nel listener creato durante l'implementazione della classe TraceListener, seguiti da un terminatore di riga.

(Ereditato da TraceListener)

Si applica a

Vedi anche