Architecture de programmation du composant EventLog
Mise à jour : novembre 2007
Le composant EventLog utilise ces parties des espaces de noms .NET Framework :
Espace de noms du composant EventLog
.gif)
Lorsque vous ajoutez une instance du composant EventLog à votre application dans Visual Studio, le système crée automatiquement les références et les instructions Import nécessaires pour accéder à l'espace de noms et aux classes. Toutefois, si vous créez vos composants EventLog dans le code ou dans Microsoft .NET Framework, vous devrez peut-être créer une référence à System.Diagnostics et ajouter à votre projet une instruction important la même bibliothèque.
Pour obtenir des instructions sur l'ajout et la suppression des références de projet, consultez Comment : ajouter ou supprimer des références dans Visual Studio (Visual Basic).
Éléments clés de programmation de la classe EventLog
Le composant EventLog déclenche un événement appelé EntryWritten chaque fois qu'une entrée est ajoutée au journal surveillé. Vous pouvez définir un gestionnaire pour cet événement. Par ailleurs, les méthodes suivantes vous permettent d'interagir avec une instance du composant EventLog :
Utilisez la méthode Exists pour déterminer si un journal des événements spécifique existe.
Utilisez la méthode CreateEventSource pour définir une chaîne créant une relation entre une source d'événements et un journal ; utilisez la méthode DeleteEventSource pour supprimer cette association. Cette méthode vous permet également de créer des journaux des événements personnalisés. Pour ce faire, entrez simplement le nom du journal dans lequel vous voulez créer la source. Le système crée alors automatiquement le journal.
.gif "Remarque")
Remarque :Vous pouvez affecter n'importe quelle chaîne à la propriété Source ; il n'est pas nécessaire qu'elle corresponde au nom de votre application. Une même application peut contenir plusieurs composants s'identifiant aux journaux des événements à l'aide de chaînes différentes.
Utilisez la méthode WriteEntry pour écrire des informations sur l'événement dans tout journal des événements auquel vous avez accès. La méthode WriteEntry inscrit automatiquement votre composant ou votre application en tant que source valide dans le journal spécifié si cette inscription n'a pas déjà eu lieu.
Utilisez la méthode SourceExists pour déterminer si une source spécifique est déjà inscrite. Cette vérification est utile lorsque vous voulez créer une nouvelle source sur un ordinateur spécifique. En effet, si la source y est déjà inscrite, la méthode SourceExists provoque une erreur d'exécution.
Utilisez la méthode GetEventLogs pour récupérer une liste de tous les journaux des événements figurant sur un ordinateur spécifique.
Utilisez la méthode Delete pour supprimer complètement un journal des événements. Cette méthode doit être utilisée avec précaution car la suppression d'un journal des événements entraîne la suppression de toute source inscrite dans celui-ci.