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 :

• Le type d'exception ou de message est Nothing (ArgumentNullException).

• Le type de message ne fait pas partie des valeurs de l'énumération TraceEventType (InvalidEnumArgumentException).

• Un code avec une confiance partielle appelle la méthode, mais écrit dans un écouteur de journalisation des événements qui requiert une confiance totale (SecurityException).

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