EventLogTraceListener Classe

Définition

Fournit un écouteur simple qui dirige la sortie de traçage ou de débogage vers un 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
Héritage
EventLogTraceListener

Exemples

L’exemple suivant crée un écouteur de suivi qui envoie la sortie vers un journal des événements.The following example creates a trace listener that sends output to an event log. Tout d’abord, le code crée un nouveau EventLogTraceListener qui utilise la source myEventLogSource .First, the code creates a new EventLogTraceListener that uses the source myEventLogSource. Ensuite, myTraceListener est ajouté à la Trace.Listeners collection.Next, myTraceListener is added to the Trace.Listeners collection. Enfin, l’exemple envoie une ligne de sortie à l' Listeners objet.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

Remarques

Une instance de ce EventLogTraceListener peut être ajoutée aux Debug.Listeners Collections, Trace.Listeners ou TraceSource.Listeners pour envoyer la sortie du traçage ou du débogage à un EventLog .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. Vous pouvez ajouter l’instance dans votre code ou la spécifier dans le fichier de configuration de l’application.You can add the instance in your code or specify it in the application configuration file. Pour ajouter un EventLogTraceListener à l’aide d’un fichier de configuration de l’application, modifiez le fichier qui correspond au nom de votre application ou le fichier app.config dans un Visual Studio 2005 :Visual Studio 2005 projet.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 2005 :Visual Studio 2005 project. Dans ce fichier, insérez un élément pour un System.Diagnostics.EventLogTraceListener type.In this file, insert an element for a System.Diagnostics.EventLogTraceListener type.

L’exemple suivant ajoute un EventLogTraceListener objet nommé myListener à la Trace.Listeners collection.The following example adds a EventLogTraceListener object named myListener to the Trace.Listeners collection. Le initializeData paramètre spécifie le nom de la source du journal des événements qui doit être passée au EventLogTraceListener(String) constructeur.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>  

Pour plus d’informations sur la façon d’ajouter des écouteurs de suivi dans le fichier de configuration de l’application, consultez ou.For more information about how to add trace listeners in the application configuration file, see or .

Notes

Si le du Source Journal des événements associé à l' EventLogTraceListener instance n’existe pas, une nouvelle source d’événements est créée.If the Source for the event log that is associated with the EventLogTraceListener instance does not exist, a new event source is created. Pour créer une source d’événements dans Windows Vista, Windows XP professionnel ou Windows Server 2003, vous devez disposer de privilèges d’administrateur.To create an event source in Windows Vista, Windows XP Professional, or Windows Server 2003, you must have administrative privileges.

La raison de cette exigence est que tous les journaux des événements, y compris la sécurité, doivent être recherchés pour déterminer si la source de l’événement est unique.The reason for this requirement is that all event logs, including security, must be searched to determine whether the event source is unique. Dans Windows Vista, les utilisateurs n’ont pas l’autorisation d’accéder au Journal de sécurité. par conséquent, une SecurityException exception est levée.In Windows Vista, users do not have permission to access the security log; therefore, a SecurityException is thrown.

Dans Windows Vista, le contrôle de compte d'utilisateur détermine les privilèges d'un utilisateur.In Windows Vista, User Account Control (UAC) determines the privileges of a user. Si vous êtes membre du groupe Administrateurs intégrés, deux jetons d'accès au moment de l'exécution vous sont assignés : un jeton d'accès utilisateur standard et un jeton d'accès administrateur.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. Par défaut, vous êtes dans le rôle d'utilisateur standard.By default, you are in the standard user role. Pour exécuter le code qui accède au Journal de sécurité, vous devez d’abord élever vos privilèges d’utilisateur standard à administrateur.To execute the code that accesses the security log, you must first elevate your privileges from standard user to administrator. Vous pouvez effectuer cela au démarrage d'une application en cliquant avec le bouton droit sur l'icône de l'application et en indiquant que vous voulez l'exécuter en tant qu'administrateur.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 fournit la EventLog propriété pour récupérer ou définir le journal des événements qui reçoit la sortie de traçage ou de débogage, et la Name propriété pour contenir le nom de EventLogTraceListener .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.

La Close méthode ferme le journal des événements afin qu’il ne reçoive plus la sortie de traçage ou de débogage.The Close method closes the event log so it no longer receives tracing or debugging output. Les Write WriteLine méthodes et écrivent un message dans le journal des événements.The Write and WriteLine methods write a message to the event log.

Notes

Pour éviter la possibilité d’écrire de grandes quantités de données dans le journal des événements, le EventLogTraceListener ne génère pas les données de trace facultatives spécifiées par la TraceOutputOptions propriété.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.

Constructeurs

EventLogTraceListener()

Initialise une nouvelle instance de la classe EventLogTraceListener sans écouteur de la trace.Initializes a new instance of the EventLogTraceListener class without a trace listener.

EventLogTraceListener(EventLog)

Initialise une nouvelle instance de la classe EventLogTraceListener à l'aide du journal des événements spécifié.Initializes a new instance of the EventLogTraceListener class using the specified event log.

EventLogTraceListener(String)

Initialise une nouvelle instance de la classe EventLogTraceListener à l'aide de la source spécifiée.Initializes a new instance of the EventLogTraceListener class using the specified source.

Propriétés

Attributes

Obtient les attributs d'écouteur de trace personnalisés définis dans le fichier de configuration de l'application.Gets the custom trace listener attributes defined in the application configuration file.

(Hérité de TraceListener)
EventLog

Obtient ou définit le journal des événements à utiliser pour l'écriture.Gets or sets the event log to write to.

Filter

Obtient ou définit le filtre de trace pour l’écouteur de la trace.Gets or sets the trace filter for the trace listener.

(Hérité de TraceListener)
IndentLevel

Obtient ou définit le niveau de retrait.Gets or sets the indent level.

(Hérité de TraceListener)
IndentSize

Obtient ou définit le nombre d'espaces dans un retrait.Gets or sets the number of spaces in an indent.

(Hérité de TraceListener)
IsThreadSafe

Obtient une valeur qui indique si l'écouteur de trace est thread-safe.Gets a value indicating whether the trace listener is thread safe.

(Hérité de TraceListener)
Name

Obtient ou définit le nom de ce EventLogTraceListener.Gets or sets the name of this EventLogTraceListener.

NeedIndent

Obtient ou définit une valeur indiquant si la sortie doit être mise en retrait.Gets or sets a value indicating whether to indent the output.

(Hérité de TraceListener)
TraceOutputOptions

Obtient ou définit les options de sortie de trace.Gets or sets the trace output options.

(Hérité de TraceListener)

Méthodes

Close()

Ferme le journal des événements pour qu'il cesse de recevoir la sortie de traçage ou de débogage.Closes the event log so that it no longer receives tracing or debugging output.

CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par TraceListener.Releases all resources used by the TraceListener.

(Hérité de TraceListener)
Dispose(Boolean)

Libère les ressources non managées utilisées par TraceListener et libère éventuellement les ressources managées.Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources.

(Hérité de TraceListener)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
Fail(String)

Émet un message d'erreur à l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.Emits an error message to the listener you create when you implement the TraceListener class.

(Hérité de TraceListener)
Fail(String, String)

Émet un message d'erreur, ainsi qu'un message d'erreur détaillé, à l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class.

(Hérité de TraceListener)
Flush()

En cas de substitution dans une classe dérivée, vide la mémoire tampon de sortie.When overridden in a derived class, flushes the output buffer.

(Hérité de TraceListener)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetLifetimeService()

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetSupportedAttributes()

Obtient les attributs personnalisés pris en charge par l'écouteur de trace.Gets the custom attributes supported by the trace listener.

(Hérité de TraceListener)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Hérité de MarshalByRefObject)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Écrit des informations de traçage, un objet de données et des informations d'événement dans le journal des événements.Writes trace information, a data object, and event information to the event log.

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

Écrit les informations sur la trace, un objet de données et les informations sur les événements dans la sortie spécifique de l'écouteur.Writes trace information, a data object and event information to the listener specific output.

(Hérité de TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Écrit des informations de traçage, un tableau contenant des objets de données et des informations d'événement dans le journal des événements.Writes trace information, an array of data objects, and event information to the event log.

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

Écrit les informations sur la trace, un tableau d'objets de données et les informations sur les événements dans la sortie spécifique de l'écouteur.Writes trace information, an array of data objects and event information to the listener specific output.

(Hérité de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Écrit les informations sur la trace et les événements dans la sortie spécifique de l'écouteur.Writes trace and event information to the listener specific output.

(Hérité de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Écrit des informations de traçage, un message et des informations d'événement dans le journal des événements.Writes trace information, a message, and event information to the event log.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Écrit les informations sur la trace, un message et les informations sur les événements dans la sortie spécifique de l'écouteur.Writes trace information, a message, and event information to the listener specific output.

(Hérité de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Écrit des informations de traçage, un tableau mis en forme contenant des objets et des informations d'événement dans le journal des événements.Writes trace information, a formatted array of objects, and event information to the event log.

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

Écrit les informations sur la trace, un tableau d'objets mis en forme et les informations sur les événements dans la sortie spécifique de l'écouteur.Writes trace information, a formatted array of objects and event information to the listener specific output.

(Hérité de TraceListener)
TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Écrit les informations sur la trace, un message, une identité d'activité connexe et les informations sur les événements dans la sortie spécifique de l'écouteur.Writes trace information, a message, a related activity identity and event information to the listener specific output.

(Hérité de TraceListener)
Write(Object)

Écrit la valeur de la méthode ToString() de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Hérité de TraceListener)
Write(Object, String)

Écrit un nom de catégorie ou la valeur de la méthode ToString() de l'objet dans l'écouteur que vous créez lors de l'implémentation de la 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.

(Hérité de TraceListener)
Write(String)

Écrit un message dans le journal des événements pour cette instance.Writes a message to the event log for this instance.

Write(String, String)

Écrit un nom de catégorie et un message dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.Writes a category name and a message to the listener you create when you implement the TraceListener class.

(Hérité de TraceListener)
WriteIndent()

Écrit la mise en retrait dans l'écouteur que vous créez lors de l'implémentation de cette classe et rétablit la valeur false à la propriété NeedIndent.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

(Hérité de TraceListener)
WriteLine(Object)

Écrit la valeur de la méthode ToString() de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener, suivie d'une marque de fin de ligne.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.

(Hérité de TraceListener)
WriteLine(Object, String)

Écrit un nom de catégorie ou la valeur de la méthode ToString() de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener, suivis d'une marque de fin de ligne.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.

(Hérité de TraceListener)
WriteLine(String)

Écrit un message dans le journal des événements pour cette instance.Writes a message to the event log for this instance.

WriteLine(String, String)

Écrit un nom de catégorie ou un message dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener, suivis d'une marque de fin de ligne.Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Hérité de TraceListener)

S’applique à

Cohérence de thread

Ce type est thread-safe.This type is thread safe.

Voir aussi