Comment : écrire dans le journal des événements de l'application

Mise à jour : novembre 2007

Vous pouvez utiliser les objets My.Application.Log et My.Log pour écrire des informations sur les événements qui se produisent dans votre application. Cet exemple indique comment configurer un écouteur de journal des événements pour que My.Application.Log écrive des informations de traçage dans le journal des événements de l'application.

Vous ne pouvez pas écrire dans le journal de sécurité. Pour écrire dans le journal système, vous devez être un membre du compte LocalSystem ou Administrateur.

Pour consulter un journal des événements, vous pouvez utiliser l'Explorateur de serveurs ou l'Observateur d'événements Windows. Pour plus d'informations, consultez Comment : utiliser des journaux des événements dans l'Explorateur de serveurs ou Comment : lancer l'Observateur d'événements à partir de l'Explorateur de serveurs.

Remarque :
Les journaux des événements ne sont pas pris en charge sous Windows 95, Windows 98 ou Windows Millennium.

Pour ajouter et configurer l'écouteur du journal des événements

1. Cliquez avec le bouton droit sur app.config dans l'Explorateur de solutions et sélectionnez l'option Ouvrir.

   ou

   S'il n'y a aucun fichier app.config,

   1. Dans le menu Projet, choisissez Ajouter un nouvel élément.

   2. Dans la boîte de dialogue Ajouter un nouvel élément, choisissez Fichier de configuration de l'application.

   3. Cliquez sur Ajouter.

2. Recherchez la section <listeners> dans le fichier de configuration de l'application.

   Vous trouverez la section <listeners> dans la section <source> portant l'attribut de nom "DefaultSource" qui est imbriquée sous la section <system.diagnostics> elle-même imbriquée sous la section <configuration> de niveau supérieur.

3. Ajoutez cet élément à la section <listeners> :

   <add name="EventLog"/>
   

4. Recherchez la section <sharedListeners> située dans la section <system.diagnostics> qui se trouve dans la section <configuration> de niveau supérieur.

5. Ajoutez cet élément à la section <sharedListeners> :

   <add name="EventLog"
       type="System.Diagnostics.EventLogTraceListener, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
        initializeData="APPLICATION_NAME"/>
   

   Remplacez APPLICATION_NAME par le nom de votre application.

   Remarque :
   En général, une application n'écrit que des erreurs dans le journal des événements. Pour plus d'informations sur le filtrage de la sortie de journal, consultez Procédure pas à pas : filtrage de la sortie de My.Application.Log.

Pour écrire des informations sur l'événement dans le journal des événements

• Utilisez la méthode My.Application.Log.WriteEntry ou My.Application.Log.WriteException pour écrire des informations dans le journal des événements. Pour plus d'informations, consultez Comment : écrire des messages de journal et Comment : enregistrer des exceptions dans Visual Basic.

  Une fois que l'écouteur du journal des événements d'un assembly configuré, il reçoit tous les messages que My.Applcation.Log écrit à partir de cet assembly.

Voir aussi

Tâches

Comment : enregistrer des exceptions dans Visual Basic

Procédure pas à pas : détermination de l'emplacement des informations My.Application.Log

Concepts

Utilisation des journaux d'applications dans Visual Basic

Référence

My.Application.Log, objet

My.Log, objet

WriteEntry, méthode (My.Application.Log et My.Log)

WriteException, méthode (My.Application.Log et My.Log)