Comment écrire dans un journal des événements à l'aide de Visual C#

IMPORTANT : Cet article est issu du système de traduction automatique mis au point par Microsoft (http://support.microsoft.com/gp/mtdetails). Un certain nombre d’articles obtenus par traduction automatique sont en effet mis à votre disposition en complément des articles traduits en langue française par des traducteurs professionnels. Cela vous permet d’avoir accès, dans votre propre langue, à l’ensemble des articles de la base de connaissances rédigés originellement en langue anglaise. Les articles traduits automatiquement ne sont pas toujours parfaits et peuvent comporter des erreurs de vocabulaire, de syntaxe ou de grammaire (probablement semblables aux erreurs que ferait une personne étrangère s’exprimant dans votre langue !). Néanmoins, mis à part ces imperfections, ces articles devraient suffire à vous orienter et à vous aider à résoudre votre problème. Microsoft s’efforce aussi continuellement de faire évoluer son système de traduction automatique.

La version anglaise de cet article est la suivante: 307024
Pour une version de Visual C++ .NET de cet article, voir 815661.
Pour une version de Microsoft Visual Basic .NET de cet article, voir 301279.

Cet article se réfère à l'espace de noms bibliothèque de classes Microsoft .NET Framework suivant :
  • System.Diagnostics

DE CETTE TÂCHE

Résumé
Cet article étape par étape vous explique comment ajouter vos propres entrées journal des événements du système d'exploitation à l'aide de Microsoft .NET Framework.

back to the top

Configuration requise

La liste suivante décrit le matériel recommandé, logiciels, infrastructure réseau et service packs dont vous aurez besoin :
  • Microsoft Windows 2000 Professionnel, Windows 2000 Server, des Windows 2000 Advanced Server ou Windows NT 4.0 Server
  • Microsoft Visual Studio Visual c#
back to the top

Écrire dans un journal des événements

Journalisation des événements offre un moyen standard et centralisé pour vos applications enregistrer les événements importants logicielles et matérielles. Windows fournit une interface utilisateur standard pour afficher les journaux, l'Observateur d'événements. En utilisant le composant de journal des événements d'exécution du langage commun, vous pouvez se connecter à journaux d'événements existants facilement sur les ordinateurs locaux et distants et écrire des entrées dans ces journaux. Vous pouvez également lire les entrées de journaux existants et créer vos propres journaux des événements personnalisés. Dans sa forme la plus simple, écrire dans un journal des événements implique quelques étapes pour créer une application exemple. Pour ce faire, procédez comme suit :
  1. Ouvrez Visual Studio Visual c#.
  2. Créer une application console dans Visual C#. L'application de console crée une classe publique et une méthode principale vide pour vous.
  3. Vérifiez que le projet référence au moins le fichier System.dll.
  4. Utiliser la directive à l'aide sur les espaces de noms System et System.Diagnostics pour ne pas avoir de qualifier les déclarations de ces espaces de noms plus loin dans votre code. Vous devez utiliser ces instructions avant toute autre déclaration.
    using System;using System.Diagnostics;					
  5. Pour écrire dans un journal des événements, vous devez avoir plusieurs éléments d'information : votre message, le nom du journal à laquelle vous souhaitez écriture (qui va être créé si il n'existe pas déjà) et une chaîne qui représente la source de l'événement. Vous pouvez enregistrer une source particulière avec uniquement un seul journal des événements ; si vous souhaitez écrire des messages dans plus d'un journal, vous devez définir plusieurs sources.
    string sSource;string sLog;string sEvent;sSource = "dotNET Sample App";sLog = "Application";sEvent = "Sample Event";					
  6. Utiliser deux méthodes statiques de la classe de journal des événements pour vérifier si votre source existe, puis, si la source n'existe pas, pour créer cette source qui est associé à un journal d'événements particulier. Si le nom de journal que vous spécifiez n'existe pas, le nom est créé automatiquement lorsque vous écrivez votre première entrée dans le journal. Par défaut, si vous ne fournissez pas un nom journal à la méthode CreateEventSource , le fichier journal est nommé « journal applications ».
    if (!EventLog.SourceExists(sSource))	EventLog.CreateEventSource(sSource,sLog);					
  7. Pour écrire un message dans un journal des événements, vous pouvez utiliser la méthode statique EventLog.WriteEntry . Cette méthode a plusieurs différentes versions de surchargées. L'exemple de code suivant illustre la méthode plus simple, qui prend une chaîne source et votre message et une des méthodes plus complexes, qui prend en charge spécifiant la l'ID d'événement et le type d'événement :
    EventLog.WriteEntry(sSource,sEvent);EventLog.WriteEntry(sSource, sEvent, EventLogEntryType.Warning,  234);					
  8. Enregistrez votre application. Exécuter votre application et vérifiez le journal Applications dans l'Observateur d'événements pour voir vos nouveaux événements.
back to the top

Terminer la liste de code

using System;using System.Diagnostics;namespace WriteToAnEventLog_csharp{	/// Summary description for Class1.	class Class1	{		static void Main(string[] args)		{			string sSource;			string sLog;			string sEvent;			sSource = "dotNET Sample App";			sLog = "Application";			sEvent = "Sample Event";			if (!EventLog.SourceExists(sSource))				EventLog.CreateEventSource(sSource,sLog);			EventLog.WriteEntry(sSource,sEvent);			EventLog.WriteEntry(sSource, sEvent,				EventLogEntryType.Warning, 234);		}	}}				
back to the top

Avertissement : Cet article a été traduit automatiquement.

Propriétés

ID d'article : 307024 - Dernière mise à jour : 12/11/2006 21:04:33 - Révision : 3.9

Microsoft Visual C# 2008 Express Edition, Microsoft Visual C# 2005, Microsoft Visual C# .NET 2002 Initiation, Microsoft Visual C# .NET 2003 Initiation

  • kbmt kbdebug kbhowtomaster KB307024 KbMtfr
Commentaires