EventProviderTraceListener Classe

Riferimento

Definizione

Spazio dei nomi:: System.Diagnostics.Eventing

Assembly:: System.Core.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à: Object

MarshalByRefObject

TraceListener
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) dall'evento di origine vengono scritti nel sottosistema ETW come stringa. Gli elementi di dati vengono delimitati usando una virgola. Per specificare un delimitatore diverso, usare la Delimiter proprietà .

Aggiunta del 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 parole chiave. Quando si abilita un provider di listener di traccia da una sessione ETW, il valore del livello specificato può essere il valore associato a uno dei valori di enumerazione seguenti System.Diagnostics.TraceEventType :

Critico (valore 1)
Errore (valore 2)
Informazioni (valore 8)
Dettagliato (valore 16)
Avviso (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 :

Ripresa (valore 2.048)
Start (valore 256)
Stop (valore 512)
Sospensione (valore è 1.024)
Trasferimento (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

TraceListener