EventProviderTraceListener Classe
Definizione
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::TraceListenerpublic class EventProviderTraceListener : System.Diagnostics.TraceListenertype EventProviderTraceListener = class
inherit TraceListenerPublic Class EventProviderTraceListener
Inherits TraceListener- Ereditarietà
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 |
| 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) |
