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.
Viene fornito un listener semplice che indirizza l'output di tracciatura o debug a 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. Innanzitutto, 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 .
int main()
{
#if defined(TRACE)
// Create a trace listener for the event log.
EventLogTraceListener^ myTraceListener =
gcnew 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" );
#endif
}
// 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 EventLogTraceListener oggetto 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>
Nota
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 delle autorizzazioni per accedere al registro di protezione. Viene pertanto generato un oggetto SecurityException.
In Windows Vista, la funzionalità Controllo dell'account utente determina i privilegi di un utente. Ai membri del gruppo Administrators predefinito vengono assegnati due token di accesso in fase di esecuzione, ovvero un token di accesso utente standard e un token di accesso amministratore. Per impostazione predefinita, viene assegnato il ruolo dell'utente standard. Per eseguire il codice che accede al log di sicurezza, è necessario innanzitutto elevare i privilegi dall'utente standard all'amministratore. È possibile farlo quando si avvia un'applicazione facendo clic con il pulsante destro del mouse sull'icona dell'applicazione e indicando l'opzione di esecuzione 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.
Nota
Per evitare la possibilità di scrivere grandi quantità di dati nel registro eventi, non EventLogTraceListener restituisce i dati di traccia facoltativi specificati dalla TraceOutputOptions proprietà .
Costruttori
| EventLogTraceListener() |
Consente di inizializzare una nuova istanza della classe EventLogTraceListener senza un listener di traccia. |
| EventLogTraceListener(EventLog) |
Consente di inizializzare una nuova istanza della classe EventLogTraceListener utilizzando il log eventi specificato. |
| EventLogTraceListener(String) |
Consente di inizializzare una nuova istanza della classe EventLogTraceListener utilizzando l'origine specificata. |
Proprietà
| Attributes |
Ottiene gli attributi personalizzati del listener di traccia definiti nel file di configurazione dell'applicazione. (Ereditato da TraceListener) |
| EventLog |
Recupera o imposta il log 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 di EventLogTraceListener. |
| 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 log eventi in modo che non riceva più 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. (Ereditato da TraceListener) |
| Flush() |
Quando se ne esegue l'override in una classe derivata, scarica il buffer di output. (Ereditato da TraceListener) |
| 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. (Ereditato da TraceListener) |
| 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 nel log eventi. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Scrive le informazioni di traccia, un oggetto dati e le informazioni di evento nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Scrive le informazioni di traccia, una matrice di oggetti dati e le informazioni di evento nel log eventi. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Scrive le informazioni di traccia, una matrice di oggetti dati e le informazioni di evento nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Scrive le informazioni di traccia e di evento nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Scrive le informazioni di traccia, un messaggio e le informazioni di evento nel log eventi. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Scrive le informazioni di traccia, un messaggio e le informazioni di evento nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Scrive le informazioni di traccia, una matrice formattata di oggetti e le informazioni di evento nel log eventi. |
| 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. (Ereditato da TraceListener) |
| 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. (Ereditato da TraceListener) |
| 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) |
Scrive un messaggio nel log eventi per questa istanza. |
| 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) |
Scrive un messaggio nel log eventi per questa istanza. |
| 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
Thread safety
Questo tipo è thread-safe.
