EventLogTraceListener 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.
Fornisce un listener semplice che indirizza l'output di traccia o debug a un oggetto EventLog.
public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListenerpublic sealed class EventLogTraceListener : System.Diagnostics.TraceListenertype EventLogTraceListener = class
inherit TraceListenerPublic NotInheritable Class EventLogTraceListener
Inherits TraceListener- Ereditarietà
Esempio
Nell'esempio seguente viene creato un listener di traccia che invia l'output a un registro eventi. Prima di tutto, il codice crea un nuovo EventLogTraceListener oggetto che usa l'origine myEventLogSource. Successivamente, myTraceListener viene aggiunto alla Trace.Listeners raccolta. Infine, l'esempio invia una riga di output all'oggetto Listeners .
// Create a trace listener for the event log.
EventLogTraceListener myTraceListener = new EventLogTraceListener("myEventLogSource");
// Add the event log trace listener to the collection.
Trace.Listeners.Add(myTraceListener);
// Write output to the event log.
Trace.WriteLine("Test output");
Overloads Public Shared Sub Main(args() As String)
' Create a trace listener for the event log.
Dim myTraceListener As New EventLogTraceListener("myEventLogSource")
' Add the event log trace listener to the collection.
Trace.Listeners.Add(myTraceListener)
' Write output to the event log.
Trace.WriteLine("Test output")
End Sub
Commenti
Un'istanza di può EventLogTraceListener essere aggiunta alle raccolte , Trace.Listenerso TraceSource.Listeners per inviare l'output Debug.Listenersdalla traccia o dal debug a un oggetto EventLog. È possibile aggiungere l'istanza nel codice o, per un'app .NET Framework, specificarla nel file di configurazione dell'applicazione.
Per aggiungere un oggetto EventLogTraceListener usando un file di configurazione dell'applicazione .NET Framework, modificare il file corrispondente al nome dell'applicazione. In questo file inserire un elemento per un System.Diagnostics.EventLogTraceListener tipo. Nell'esempio seguente viene aggiunto un EventLogTraceListener oggetto denominato myListener all'insieme Trace.Listeners . Il initializeData parametro specifica il nome dell'origine del registro eventi da passare al EventLogTraceListener(String) costruttore.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="myListener"
type="System.Diagnostics.EventLogTraceListener"
initializeData="TraceListenerLog" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Annotazioni
Se per Source il registro eventi associato all'istanza EventLogTraceListener non esiste, viene creata una nuova origine evento. Per creare un'origine evento in Windows Vista, Windows XP Professional o Windows Server 2003, è necessario disporre di privilegi amministrativi.
Il motivo di questo requisito è che tutti i registri eventi, inclusa la sicurezza, devono essere cercati per determinare se l'origine evento è univoca. In Windows Vista gli utenti non dispongono dell'autorizzazione per accedere al log di sicurezza; pertanto, viene generata un'eccezione SecurityException .
In Windows Vista il controllo dell'account utente determina i privilegi di un utente. Se si è membri del gruppo Administrators predefinito, vengono assegnati due token di accesso in fase di esecuzione: un token di accesso utente standard e un token di accesso amministratore. Per impostazione predefinita, si è nel ruolo utente standard. Per eseguire il codice che accede al log di sicurezza, è prima necessario elevare i privilegi dall'utente standard all'amministratore. A tale scopo, è possibile avviare un'applicazione facendo clic con il pulsante destro del mouse sull'icona dell'applicazione e indicando che si vuole eseguire come amministratore.
La classe fornisce la EventLog proprietà per ottenere o impostare il registro eventi che riceve l'output di traccia o debug e la Name proprietà per contenere il nome dell'oggetto EventLogTraceListener.
Il Close metodo chiude il registro eventi in modo che non riceva più l'output di traccia o debug. I Write metodi e WriteLine scrivono un messaggio nel registro eventi.
Annotazioni
Per evitare la possibilità di scrivere grandi quantità di dati nel registro eventi, EventLogTraceListener non restituisce i dati di traccia facoltativi specificati dalla TraceOutputOptions proprietà .
Costruttori
| Nome | Descrizione |
|---|---|
| EventLogTraceListener() |
Inizializza una nuova istanza della EventLogTraceListener classe senza un listener di traccia. |
| EventLogTraceListener(EventLog) |
Inizializza una nuova istanza della EventLogTraceListener classe utilizzando il registro eventi specificato. |
| EventLogTraceListener(String) |
Inizializza una nuova istanza della EventLogTraceListener classe utilizzando l'origine specificata. |
Proprietà
| Nome | Descrizione |
|---|---|
| Attributes |
Ottiene gli attributi del listener di traccia personalizzati definiti nel file di configurazione dell'applicazione. (Ereditato da TraceListener) |
| EventLog |
Ottiene o imposta il registro eventi in cui scrivere. |
| 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. (Ereditato da TraceListener) |
| Name |
Ottiene o imposta il nome dell'oggetto EventLogTraceListener. |
| NeedIndent |
Ottiene o imposta un valore che indica se impostare il rientro dell'output. (Ereditato da TraceListener) |
| TraceOutputOptions |
Ottiene o imposta le opzioni di output della traccia. (Ereditato da TraceListener) |
Metodi
| Nome | Descrizione |
|---|---|
| Close() |
Chiude il registro eventi in modo che non riceva più l'output di traccia o debug. |
| CreateObjRef(Type) |
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare 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, rilascia le risorse gestite. (Ereditato da TraceListener) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| Fail(String, String) |
Genera un messaggio di errore e un messaggio di errore dettagliato al listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Fail(String) |
Genera un messaggio di errore al listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Flush() |
Quando sottoposto a override in una classe derivata, scarica il buffer di output. (Ereditato da TraceListener) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Obsoleti.
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| GetSupportedAttributes() |
Ottiene gli attributi personalizzati supportati dal listener di traccia. (Ereditato da TraceListener) |
| GetType() |
Ottiene il 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 del Objectcorrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Scrive informazioni di traccia, un oggetto dati e informazioni sugli eventi nel registro eventi. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Scrive informazioni di traccia, una matrice di oggetti dati e informazioni sugli eventi nel registro eventi. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Scrive informazioni di traccia, una matrice formattata di oggetti e informazioni sugli eventi nel registro eventi. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Scrive le informazioni di traccia, un messaggio e le informazioni sugli eventi nel registro eventi. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Scrive le informazioni di traccia e evento nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Scrive informazioni di traccia, un messaggio, un'identità di attività correlata e informazioni sugli eventi nell'output specifico del listener. (Ereditato da TraceListener) |
| Write(Object, String) |
Scrive un nome di categoria e il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Write(Object) |
Scrive il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Write(String, String) |
Scrive un nome di categoria e un messaggio nel listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Write(String) |
Scrive un messaggio nel registro eventi per questa istanza. |
| WriteIndent() |
Scrive il rientro nel listener creato quando si implementa questa classe e la proprietà viene reimpostata NeedIndent su |
| WriteLine(Object, String) |
Scrive un nome di categoria e il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe, seguita da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(Object) |
Scrive il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe, seguita da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(String, String) |
Scrive un nome di categoria e un messaggio nel listener creato quando si implementa la TraceListener classe , seguito da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(String) |
Scrive un messaggio nel registro eventi per questa istanza. |
Si applica a
Thread safety
Questo tipo è thread-safe.
