Journal des événements, exemple

Mise à jour : novembre 2007

Cet exemple illustre la création et la suppression de journaux des événements ainsi que la lecture et l'écriture dans des journaux des événements système et des journaux des événements personnalisés.

Visual Basic propose deux mécanismes d'enregistrement différents :

• Le composant EventLog, utilisé dans cet exemple, fournit l'accès aux journaux des événements du système d'exploitation. Vous pouvez ajouter et supprimer des journaux, ajouter et supprimer des sources de journaux d'événements, écrire et supprimer des messages.

• L'objet My.Application.Log fournit également l'accès à certaines des fonctionnalités EventLog. De plus, My.Application.Log possède des fonctionnalités qui vous permettent d'écrire des messages dans des fichiers texte. Pour plus d'informations, consultez Enregistrement dans un journal, exemple et Enregistrement d'informations provenant de l'application.

Pour obtenir des exemples et leurs instructions d'installation

• Effectuez une ou plusieurs des opérations suivantes :

  • Dans le menu ? (Aide), cliquez sur Exemples.

    Le fichier Readme contient des informations sur les exemples.

  • Accédez au site Web Exemples Visual Studio 2008. La version la plus récente des exemples est disponible sur ce site.

  • Recherchez les exemples sur l'ordinateur sur lequel Visual Studio est installé. Par défaut, les exemples et un fichier Readme sont installés sous lecteur:\Program Files\Microsoft Visual Studio 9.0\Samples\1036. Pour les versions Express de Visual Studio, tous les exemples sont disponibles en ligne.

Pour plus d'informations, consultez Recherche des fichiers d'exemple.

.

Note de sécurité :

Cet exemple de code est destiné à illustrer un concept ; il présente uniquement le code qui se rapporte spécifiquement à ce concept. Il est possible qu'il ne réponde pas aux exigences de sécurité d'un environnement spécifique, et ne doit pas être utilisé exactement comme indiqué. Nous vous recommandons d'ajouter du code de sécurité et de gestion des erreurs afin de renforcer la sécurité et la fiabilité de vos projets. Microsoft fournit cet exemple de code « EN L'ÉTAT » sans aucune garantie.

Pour exécuter cet exemple

• Appuyez sur F5.

  Tous les systèmes d'exploitation ne prennent pas en charge les journaux des événements. Pour plus d'informations, consultez EventLog.

Démonstrations

Le formulaire principal, Form1, contient trois contrôles Button pour lire, écrire et créer ou supprimer des journaux des événements. Chacun ouvre un nouveau formulaire qui collecte des informations spécifiques à l'opération.

Le formulaire WriteForm collecte le texte, l'ID et le type pour une entrée du journal des événements et écrit l'entrée dans le journal des événements de l'application à l'aide de la méthode WriteEntry.

Le formulaire ReadForm remplit un contrôle ListBox avec les noms des journaux des événements sur l'ordinateur. La liste est obtenue en appelant la méthode GetEventLogs, puis en affichant la valeur de la propriété LogDisplayName pour chaque journal. Les dix dernières entrées du journal sélectionné sont récupérées à l'aide de la propriété Entries, puis affichées dans un contrôle RichTextBox.

Le formulaire CreateDeleteForm appelle les méthodes CreateEventSource et Delete. La méthode SourceExists est utilisée pour vérifier que le journal des événements et la source n'existent pas déjà avant de les créer. La méthode Exists est utilisée pour vérifier que le journal des événements existe avant de le supprimer.

Voir aussi

Tâches

Enregistrement dans un journal, exemple

Concepts

Introduction au composant EventLog

Enregistrement d'informations provenant de l'application

Référence

EventLog

System.Diagnostics