EventLogTraceListener Classe

Definizione

Viene fornito un listener semplice che indirizza l'output di tracciatura o debug a EventLog.Provides a simple listener that directs tracing or debugging output to an EventLog.

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

Esempi

Nell'esempio seguente viene creato un listener di traccia che invia l'output a un log eventi.The following example creates a trace listener that sends output to an event log. Innanzitutto, il codice crea un nuovo EventLogTraceListener oggetto che usa l' myEventLogSourceorigine.First, the code creates a new EventLogTraceListener that uses the source myEventLogSource. Successivamente, myTraceListener viene aggiunto Trace.Listeners alla raccolta.Next, myTraceListener is added to the Trace.Listeners collection. Infine, nell'esempio viene inviata una riga di output all' Listeners oggetto.Finally, the example sends a line of output to the Listeners object.

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
}
public static void Main(string[] args) {

    // 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 questo EventLogTraceListener oggetto può essere aggiunta Debug.Listenersalle raccolte Trace.Listeners, o TraceSource.Listeners per inviare l'output dalla traccia o dal debug a EventLogun.An instance of this EventLogTraceListener can be added to the Debug.Listeners, Trace.Listeners, or TraceSource.Listeners collections to send output from tracing or debugging to an EventLog. È possibile aggiungere l'istanza nel codice o specificarla nel file di configurazione dell'applicazione.You can add the instance in your code or specify it in the application configuration file. Per aggiungere un EventLogTraceListener oggetto utilizzando un file di configurazione dell'applicazione, modificare il file che corrisponde al nome dell'applicazione o del file app. config in Visual Studio 2005Visual Studio 2005 un progetto.To add an EventLogTraceListener using an application configuration file, edit the file that corresponds to the name of your application or the app.config file in a Visual Studio 2005Visual Studio 2005 project. In questo file inserire un elemento per un System.Diagnostics.EventLogTraceListener tipo.In this file, insert an element for a System.Diagnostics.EventLogTraceListener type.

Nell'esempio seguente viene aggiunto EventLogTraceListener un oggetto myListener denominato alla Trace.Listeners raccolta.The following example adds a EventLogTraceListener object named myListener to the Trace.Listeners collection. Il initializeData parametro specifica il nome dell'origine del log eventi da passare EventLogTraceListener(String) al costruttore.The initializeData parameter specifies the name of the event log source that is to be passed to the EventLogTraceListener(String) constructor.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener"  
          type="System.Diagnostics.EventLogTraceListener"  
          initializeData="TraceListenerLog" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Per ulteriori informazioni su come aggiungere listener di traccia nel file di configurazione dell'applicazione, vedere o.For more information about how to add trace listeners in the application configuration file, see or .

Nota

Se per il registro eventi associato EventLogTraceListener all'istanza non esiste, viene creata una nuova origine evento. SourceIf the Source for the event log that is associated with the EventLogTraceListener instance does not exist, a new event source is created. Per creare un'origine evento in Windows Vista, Windows XP Professional o Windows Server 2003, è necessario disporre di privilegi amministrativi.To create an event source in Windows Vista, Windows XP Professional, or Windows Server 2003, you must have administrative privileges.

Il motivo di questo requisito è che è necessario cercare tutti i registri eventi, inclusa la sicurezza, per determinare se l'origine evento è univoca.The reason for this requirement is that all event logs, including security, must be searched to determine whether the event source is unique. In Windows Vista, gli utenti non dispongono delle autorizzazioni per accedere al registro di protezione. Viene pertanto generato un oggetto SecurityException.In Windows Vista, users do not have permission to access the security log; therefore, a SecurityException is thrown.

In Windows Vista, la funzionalità Controllo dell'account utente determina i privilegi di un utente.In Windows Vista, User Account Control (UAC) determines the privileges of a user. 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.If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. Per impostazione predefinita, viene assegnato il ruolo dell'utente standard.By default, you are in the standard user role. Per eseguire il codice che accede al registro di sicurezza, è prima di tutto necessario elevare i privilegi da utente standard a amministratore.To execute the code that accesses the security log, you must first elevate your privileges from standard user to administrator. È 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.You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator.

La classe fornisce la EventLog proprietà per ottenere o impostare il registro eventi che riceve l'output di tracciatura o di debug Name e la proprietà per mantenere il nome EventLogTraceListenerdell'oggetto.The class provides the EventLog property to get or set the event log that receives the tracing or debugging output, and the Name property to hold the name of the EventLogTraceListener.

Il Close metodo chiude il registro eventi in modo che non riceva più output di tracciatura o di debug.The Close method closes the event log so it no longer receives tracing or debugging output. I Write metodi WriteLine e scrivono un messaggio nel log eventi.The Write and WriteLine methods write a message to the event log.

Nota

Per evitare la possibilità di scrivere grandi quantità di dati nel registro eventi, EventLogTraceListener in non vengono restituiti i dati di traccia facoltativi specificati TraceOutputOptions dalla proprietà.To avoid the possibility of writing large amounts of data to the event log, the EventLogTraceListener does not output the optional trace data specified by the TraceOutputOptions property.

Costruttori

EventLogTraceListener()

Consente di inizializzare una nuova istanza della classe EventLogTraceListener senza un listener di traccia.Initializes a new instance of the EventLogTraceListener class without a trace listener.

EventLogTraceListener(EventLog)

Consente di inizializzare una nuova istanza della classe EventLogTraceListener utilizzando il log eventi specificato.Initializes a new instance of the EventLogTraceListener class using the specified event log.

EventLogTraceListener(String)

Consente di inizializzare una nuova istanza della classe EventLogTraceListener utilizzando l'origine specificata.Initializes a new instance of the EventLogTraceListener class using the specified source.

Proprietà

Attributes

Ottiene gli attributi personalizzati del listener di traccia definiti nel file di configurazione dell'applicazione.Gets the custom trace listener attributes defined in the application configuration file.

(Ereditato da TraceListener)
EventLog

Recupera o imposta il log eventi in cui scrivere.Gets or sets the event log to write to.

Filter

Ottiene o imposta il filtro di traccia per il listener di traccia.Gets or sets the trace filter for the trace listener.

(Ereditato da TraceListener)
IndentLevel

Ottiene o imposta il livello di rientro.Gets or sets the indent level.

(Ereditato da TraceListener)
IndentSize

Ottiene o imposta il numero di spazi in un rientro.Gets or sets the number of spaces in an indent.

(Ereditato da TraceListener)
IsThreadSafe

Ottiene un valore che indica se il listener di traccia è thread-safe.Gets a value indicating whether the trace listener is thread safe.

(Ereditato da TraceListener)
Name

Ottiene o imposta il nome di EventLogTraceListener.Gets or sets the name of this EventLogTraceListener.

NeedIndent

Ottiene o imposta un valore che indica se impostare il rientro dell'output.Gets or sets a value indicating whether to indent the output.

(Ereditato da TraceListener)
TraceOutputOptions

Ottiene o imposta le opzioni dell'output di traccia.Gets or sets the trace output options.

(Ereditato da TraceListener)

Metodi

Close()

Chiude il log eventi in modo che non riceva più output di tracciatura o di debug.Closes the event log so that it no longer receives tracing or debugging output.

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da TraceListener.Releases all resources used by the TraceListener.

(Ereditato da TraceListener)
Dispose(Boolean)

Rilascia le risorse non gestite usate da TraceListener e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources.

(Ereditato da TraceListener)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Fail(String)

Genera un messaggio di errore nel listener creato durante l'implementazione della classe TraceListener.Emits an error message to the listener you create when you implement the TraceListener class.

(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.Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class.

(Ereditato da TraceListener)
Flush()

Quando se ne esegue l'override in una classe derivata, svuota il buffer di output.When overridden in a derived class, flushes the output buffer.

(Ereditato da TraceListener)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetSupportedAttributes()

Ottiene gli attributi personalizzati supportati dal listener di traccia.Gets the custom attributes supported by the trace listener.

(Ereditato da TraceListener)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(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.Writes trace information, a data object, and event information to the event log.

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

Scrive le informazioni di traccia, una matrice di oggetti dati e le informazioni di evento nel log eventi.Writes trace information, an array of data objects, and event information to the event log.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Scrive le informazioni di traccia e di evento nell'output specifico del listener.Writes trace and event information to the listener specific output.

(Ereditato da TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Scrive le informazioni di traccia, un messaggio e le informazioni di evento nel log eventi.Writes trace information, a message, and event information to the event log.

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.Writes trace information, a formatted array of objects, and event information to the event log.

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.Writes trace information, a message, a related activity identity and event information to the listener specific output.

(Ereditato da TraceListener)
Write(Object)

Scrive il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(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.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Ereditato da TraceListener)
Write(String)

Scrive un messaggio nel log eventi per questa istanza.Writes a message to the event log for this instance.

Write(String, String)

Scrive un nome di categoria e un messaggio nel listener creato durante l'implementazione della classe TraceListener.Writes a category name and a message to the listener you create when you implement the TraceListener class.

(Ereditato da TraceListener)
WriteIndent()

Inserisce il rientro nel listener creato quando si implementa questa classe e reimposta la proprietà NeedIndent su false.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to 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.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

(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.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Ereditato da TraceListener)
WriteLine(String)

Scrive un messaggio nel log eventi per questa istanza.Writes a message to the event log for this instance.

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.Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Ereditato da TraceListener)

Si applica a

Thread safety

Questo tipo è thread-safe.This type is thread safe.

Vedi anche