Enregistrement dans un journal, exemple
Mise à jour : novembre 2007
Cet exemple montre comment utiliser et configurer l'objet My.Application.Log.
Visual Basic offre deux mécanismes d'enregistrement différents. My.Application.Log fournit l'accès aux journaux des événements du système d'exploitation et vous permet également d'écrire des messages dans des fichiers texte. Le composant EventLog fournit l'accès aux journaux des événements du système d'exploitation. Le composant EventLog vous permet d'ajouter et de supprimer des journaux, d'ajouter et de supprimer des sources de journal des événements, d'écrire et de supprimer des messages. Pour obtenir un exemple de code, consultez Journal des événements, exemple.
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.
.
.gif "Note de sécurité") 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. Le formulaire principal répertorie les écouteurs qui sont configurés pour l'exemple.
Écrivez un message dans le contrôle TextBox sur le formulaire.
Cliquez sur le bouton Write Log Message.
Le message est écrit dans chacun des écouteurs.
Le chemin d'accès au fichier XML écrit par XmlWriterTraceListener est c:\logsamples\SampleLog.xml.
Le fichier texte simple écrit par FileLogTraceListener se trouve dans votre répertoire "Application Data". Si vous exécutez le programme dans Visual Studio, le chemin d'accès est du type « c:\Documents And Settings\[utilisateur]\Application Data\Microsoft Corporation\Microsoft Visual Studio \[8.0*] \LogSample.log ».
Démonstrations
Cet exemple contient :
Form1 Fournit un formulaire simple qui affiche tous les écouteurs actuellement activés pour My.Application.Log et dispose de contrôles qui permettent que du texte soit écrit dans My.Application.Log.
app.config Définit la configuration pour My.Application.Log (où les messages doivent être écrits, quels sont les messages qui doivent être filtrés, etc.).
Cet exemple montre comment My.Application.Log peut être utilisé pour écrire un fichier texte simple, le journal des événements et un fichier XML. Vous pouvez implémenter facilement un TraceListener personnalisé qui écrit également dans d'autres emplacements, tels qu'une base de données ou un message électronique.
La "Gravité" sélectionnée sur le formulaire est assignée à chaque message. Lorsque l'écouteur reçoit le message, il peut ignorer le message selon son niveau de filtre. Par exemple, le composant EventLogTraceListener est configuré uniquement pour écrire des messages d'erreur ; par conséquent, tous les messages que vous écrivez avec un niveau de gravité "Information" ou "Avertissement" sont écrits dans le fichier XML et dans le fichier texte brut, et pas dans EventLog.
Pour modifier le comportement de l'exemple, modifiez le fichier app.config du projet. Les commentaires dans le fichier servent de guide pour les modifications.
Vous pouvez utiliser My.Application.Log et le modèle d'application pour enregistrer des exceptions de démarrage, des exceptions d'arrêt et des exceptions non gérées. Pour consulter le code pour cet exemple, double-cliquez sur My Project dans l'Explorateur de solutions. Dans le volet Application, cliquez sur le bouton Afficher le code.
Voir aussi
Tâches
Journal des événements, exemple