Partager via


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

Mise à jour : novembre 2007

Écrit un message dans les écouteurs de journalisation de l'application.

' Usage
My.Application.Log.WriteEntry(message)
My.Application.Log.WriteEntry(message ,severity)
My.Application.Log.WriteEntry(message ,severity ,id)
' Web usage
My.Log.WriteEntry(message)
My.Log.WriteEntry(message ,severity)
My.Log.WriteEntry(message ,severity ,id)
' Declaration
Public Sub WriteEntry( _
   ByVal message As String _
)
' -or-
Public Sub WriteEntry( _
   ByVal message As String, _
   ByVal severity As System.Diagnostics.TraceEventType _
)
' -or-
Public Sub WriteEntry( _
   ByVal message As String, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal id As Integer _
)

Paramètres

  • message
    Obligatoire. Message à enregistrer. Si message a la valeur Nothing, une chaîne vide est utilisée.

  • severity
    Type de message. Par défaut, TraceEventType.Information.

  • id
    Identificateur de message, généralement utilisé pour la corrélation. Par défaut, associé à entryType, comme décrit dans le tableau.

Exceptions

Les conditions ci-dessous génèrent une exception :

Notes

La méthode WriteEntry écrit un message dans les écouteurs de journalisation des événements de l'application.

Dans les applications clientes, l'objet Log est disponible par l'intermédiaire de l'objet My.Application.Log. Dans les applications Web, l'objet Log est disponible par l'intermédiaire de l'objet My.Log.

Pour déterminer les écouteurs de journalisation qui reçoivent les messages de la méthode WriteEntry, consultez Procédure pas à pas : détermination de l'emplacement des informations My.Application.Log. Vous pouvez modifier des écouteurs de journalisation par défaut. Pour plus d'informations, consultez Utilisation des journaux d'applications dans Visual Basic.

Pour les surcharges qui n'acceptent pas l'argument id, l'id écrit dans le journal est défini par le tableau suivant.

severity

id par défaut

Information

0

Warning

1

Error

2

Critical

3

Start

4

Stop

5

Suspend

6

Resume

7

Verbose

8

Transfer

9

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la méthode WriteEntry.

Pour

Consultez

Écrire des informations sur les événements dans les écouteurs de journalisation de l'application

Comment : écrire des messages de journal

Déterminer l'emplacement où Log écrit les informations

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

Exemple

Cet exemple montre comment utiliser la méthode My.Application.Log.WriteEntry pour enregistrer des informations de traçage. Pour plus d'informations, consultez Comment : écrire des messages de journal.

Public Sub TracingTest(ByVal fileName As String)
    My.Application.Log.WriteEntry( _
        "Entering TracingTest with argument " & _
        fileName & ".")
    ' Code to trace goes here.
    My.Application.Log.WriteEntry( _
        "Exiting TracingTest with argument " & _
        fileName & ".")
End Sub

Cet exemple de code ne peut s'exécuter que dans une application cliente. Remplacez My.Application.Log.WriteEntry par My.Log.WriteEntry pour les applications Web.

Configuration requise

Espace de noms :Microsoft.VisualBasic.Logging

Classe :Log

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet

Disponible

Application Windows

Oui

Bibliothèque de classes

Oui

Application console

Oui

Bibliothèque de contrôles Windows

Oui

Bibliothèque de contrôles Web

Non

Service Windows

Oui

Site Web

Oui

Autorisations

L'autorisation suivante peut être nécessaire :

Autorisation

Description

FileIOPermission

Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted.

Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.

Voir aussi

Tâches

Comment : écrire des messages de journal

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

System.Diagnostics.TraceEventType

Log.WriteEntry