Comment : lire les entrées d'un journal des événements

Mise à jour : novembre 2007

La collection Entries permet de lire le contenu d'un journal des événements spécifique. Vous pouvez utiliser les propriétés de collection standard, telles que Count et Item, pour manipuler les éléments de la collection. Vous pouvez ainsi lire les entrées d'un journal des événements pour obtenir plus d'informations sur un problème survenu dans votre système, identifier des modèles d'utilisation ou détecter tout problème éventuel (tel une panne du disque dur) avant qu'il n'affecte votre système.

Remarque :
La collection Entries est en lecture seule ; vous devez donc utiliser la méthode WriteEntry pour écrire un message dans un journal des événements. Pour plus d'informations, consultez Comment : écrire des entrées dans des journaux des événements.

Lorsque vous vérifiez le nombre d'entrées d'un nouveau journal des événements personnalisé ne contenant aucune entrée, le système retourne le nombre d'entrées du journal d'applications de ce serveur. Pour éviter ce problème, assurez-vous que les journaux des événements concernés ont été créés, et qu'ils contiennent des entrées.

Remarque :
Certaines restrictions de sécurité s'appliquent à l'utilisation des journaux des événements. Pour plus d'informations, consultez Ramifications de sécurité des journaux des événements.

Note de sécurité :
Considérez les données d'un journal des événements comme toute autre entrée provenant de l'extérieur de votre système. Votre application devra peut-être valider les données du journal des événements avant de les utiliser comme entrées. Il est possible qu'un autre processus, peut-être nuisible, ait accédé au journal des événements et y ait ajouté des entrées.

Pour lire les entrées d'un journal des événements

1. Créez une instance du composant EventLog. Pour plus d'informations, consultez Comment : créer des instances du composant EventLog.

2. Définissez les propriétés Log et MachineName du composant. Pour plus d'informations, consultez Comment : configurer des instances du composant EventLog.

3. Vérifiez les entrées du journal des événements à l'aide de la collection Entries. L'exemple suivant montre comment récupérer toutes les entrées d'un journal des événements.

   Dim entry As EventLogEntry
   For Each entry In EventLog1.Entries
       Console.WriteLine(entry.Message)
   Next
   

        foreach (System.Diagnostics.EventLogEntry entry in EventLog1.Entries)
           {
               Console.WriteLine(entry.Message);
   
           }
   

Voir aussi

Tâches

Comment : gérer l'événement EntryWritten

Procédure pas à pas : exploration des journaux des événements, des sources d'événements et des entrées

Concepts

Introduction au composant EventLog