EventLogTraceListener Classe

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Paquet:

System.Diagnostics.EventLog v8.0.0

Source:

EventLogTraceListener.cs

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

Object

MarshalByRefObject

TraceListener

EventLogTraceListener

Exemples

L’exemple suivant crée un écouteur de trace qui envoie une sortie à un journal des événements. Tout d’abord, le code en crée un qui EventLogTraceListener utilise la source myEventLogSource. Ensuite, myTraceListener est ajouté à la Trace.Listeners collection. Enfin, l’exemple envoie une ligne de sortie à l’objet 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

Remarques

Une instance de ce EventLogTraceListener peut être ajoutée aux Debug.Listenerscollections , Trace.Listenersou TraceSource.Listeners pour envoyer la sortie du suivi ou du débogage à un EventLog. Vous pouvez ajouter le instance dans votre code ou, pour une application .NET Framework, le spécifier dans le fichier de configuration de l’application.

Pour ajouter un à l’aide d’un EventLogTraceListener fichier de configuration d’application .NET Framework, modifiez le fichier qui correspond au nom de votre application. Dans ce fichier, insérez un élément pour un System.Diagnostics.EventLogTraceListener type. L’exemple suivant ajoute un EventLogTraceListener objet nommé myListener à la Trace.Listeners collection. Le initializeData paramètre spécifie le nom de la source du journal des événements qui doit être transmise au EventLogTraceListener(String) constructeur.

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

Notes

Si le Source pour le journal des événements associé au EventLogTraceListener instance n’existe pas, une nouvelle source d’événements est créée. Pour créer une source d’événement dans Windows Vista, Windows XP Professionnel ou Windows Server 2003, vous devez disposer de privilèges d’administrateur.

La raison de cette exigence est que tous les journaux d’événements, y compris la sécurité, doivent être recherchés pour déterminer si la source d’événement est unique. Dans Windows Vista, les utilisateurs n’ont pas l’autorisation d’accéder au journal de sécurité ; par conséquent, un SecurityException est jeté.

Dans Windows Vista, le contrôle de compte d'utilisateur détermine les privilèges d'un utilisateur. 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. Par défaut, vous êtes dans le rôle d'utilisateur standard. 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. 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.

La classe fournit la EventLog propriété permettant d’obtenir ou de définir le journal des événements qui reçoit la sortie de suivi ou de débogage, et la Name propriété pour contenir le nom du EventLogTraceListener.

La Close méthode ferme le journal des événements afin qu’il ne reçoive plus de sortie de suivi ou de débogage. Les Write méthodes et WriteLine écrivent un message dans le journal des événements.

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é .

Constructeurs

EventLogTraceListener()	Initialise une nouvelle instance de la classe EventLogTraceListener sans écouteur de la trace.
EventLogTraceListener(EventLog)	Initialise une nouvelle instance de la classe EventLogTraceListener à l'aide du journal des événements spécifié.
EventLogTraceListener(String)	Initialise une nouvelle instance de la classe EventLogTraceListener à l'aide de la source spécifiée.

Propriétés

Attributes	Obtient les attributs d'écouteur de trace personnalisés définis dans le fichier de configuration de l'application. (Hérité de TraceListener)
EventLog	Obtient ou définit le journal des événements à utiliser pour l'écriture.
Filter	Obtient ou définit le filtre de trace pour l’écouteur de la trace. (Hérité de TraceListener)
IndentLevel	Obtient ou définit le niveau de retrait. (Hérité de TraceListener)
IndentSize	Obtient ou définit le nombre d'espaces dans un retrait. (Hérité de TraceListener)
IsThreadSafe	Obtient une valeur qui indique si l'écouteur de trace est thread-safe. (Hérité de TraceListener)
Name	Obtient ou définit le nom de ce EventLogTraceListener.
NeedIndent	Obtient ou définit une valeur indiquant si la sortie doit être mise en retrait. (Hérité de TraceListener)
TraceOutputOptions	Obtient ou définit les options de sortie de trace. (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.
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. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par 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. (Hérité de TraceListener)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (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. (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. (Hérité de TraceListener)
Flush()	En cas de substitution dans une classe dérivée, vide la mémoire tampon de sortie. (Hérité de TraceListener)
GetHashCode()	Fait office de fonction de hachage par défaut. (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. (Hérité de MarshalByRefObject)
GetSupportedAttributes()	Obtient les attributs personnalisés pris en charge par l'écouteur de trace. (Hérité de TraceListener)
GetType()	Obtient le Type de l'instance actuelle. (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. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
ToString()	Retourne une chaîne qui représente l'objet actuel. (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.
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.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Écrit les informations sur la trace et les événements dans la sortie spécifique de l'écouteur. (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.
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.
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. (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. (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. (Hérité de TraceListener)
Write(String)	Écrit un message dans le journal des événements pour cette 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. (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. (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. (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. (Hérité de TraceListener)
WriteLine(String)	Écrit un message dans le journal des événements pour cette 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. (Hérité de TraceListener)

Cohérence de thread

Ce type est thread-safe.

Voir aussi

• TraceListener
• DefaultTraceListener
• TextWriterTraceListener
• EventLog
• Stream
• TextWriter
• Debug
• Trace