Log.WriteEntry Méthode

Référence

Définition

Espace de noms:: Microsoft.VisualBasic.Logging

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Surcharges

WriteEntry(String)	Écrit un message dans les écouteurs de journalisation de l'application.
WriteEntry(String, TraceEventType)	Écrit un message dans les écouteurs de journalisation de l'application.
WriteEntry(String, TraceEventType, Int32)	Écrit un message dans les écouteurs de journalisation de l'application.

WriteEntry(String)

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

public:
 void WriteEntry(System::String ^ message);

public void WriteEntry (string message);

member this.WriteEntry : string -> unit

Public Sub WriteEntry (message As String)

Paramètres

message: String

Obligatoire. Message à consigner. Si message est Nothing, une chaîne vide est utilisée.

Exceptions

SecurityException

Le code d'un niveau de confiance partiel appelle la méthode, mais effectue l'écriture dans un écouteur de journal des événements qui requiert une confiance totale.

Exemples

Cet exemple montre comment utiliser la méthode My.Application.Log.WriteEntry pour enregistrer des informations de traçage. Pour plus d’informations, consultez Guide pratique pour é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 peut s’exécuter uniquement dans une application cliente. Remplacez par My.Application.Log.WriteEntryMy.Log.WriteEntry pour les applications web.

Remarques

La WriteEntry méthode écrit un message dans les écouteurs du journal des événements de l’application.

Dans les applications clientes, l’objet Log est disponible via l’objet My.Application.Log . Dans les applications web, l’objet Log est disponible via l’objet My.Log .

Pour savoir quels écouteurs de journal reçoivent les messages de la WriteEntry méthode, consultez Procédure pas à pas : détermination de l’emplacement où My.Application.Log écrit des informations. Vous pouvez modifier les écouteurs de journal par défaut. Pour plus d’informations, consultez Utilisation des journaux d’application.

Pour les surcharges qui ne prennent pas l’argument id , l’écrit id dans le journal est défini par le tableau suivant.

`severity`	Par défaut `id`
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

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

À	Consultez
Écrire des informations sur les événements dans les écouteurs de journal de l’application	Procédure : écrire des messages de journal
Déterminer où `Log` écrit les informations	Procédure pas à pas : détermination de l’emplacement des informations My.Application.Log

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

Voir aussi

S’applique à

WriteEntry(String, TraceEventType)

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

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::TraceEventType severity);

public void WriteEntry (string message, System.Diagnostics.TraceEventType severity);

member this.WriteEntry : string * System.Diagnostics.TraceEventType -> unit

Public Sub WriteEntry (message As String, severity As TraceEventType)

Paramètres

message: String

Obligatoire. Message à consigner. Si message est Nothing, une chaîne vide est utilisée.

severity: TraceEventType

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

Exceptions

InvalidEnumArgumentException

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

SecurityException

Le code d'un niveau de confiance partiel appelle la méthode, mais effectue l'écriture dans un écouteur de journal des événements qui requiert une confiance totale.

Exemples

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 peut s’exécuter uniquement dans une application cliente. Remplacez par My.Application.Log.WriteEntryMy.Log.WriteEntry pour les applications web.

Remarques

La WriteEntry méthode écrit un message dans les écouteurs du journal des événements de l’application.

Dans les applications clientes, l’objet Log est disponible via l’objet My.Application.Log . Dans les applications web, l’objet Log est disponible via l’objet My.Log .

Pour les surcharges qui ne prennent pas l’argument id , l’écrit id dans le journal est défini par le tableau suivant.

`severity`	Par défaut `id`
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

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

À	Consultez
Écrire des informations sur les événements dans les écouteurs de journal de l’application	Procédure : écrire des messages de journal
Déterminer où `Log` écrit les informations	Procédure pas à pas : détermination de l’emplacement des informations My.Application.Log

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

Voir aussi

S’applique à

WriteEntry(String, TraceEventType, Int32)

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

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::TraceEventType severity, int id);

public void WriteEntry (string message, System.Diagnostics.TraceEventType severity, int id);

member this.WriteEntry : string * System.Diagnostics.TraceEventType * int -> unit

Public Sub WriteEntry (message As String, severity As TraceEventType, id As Integer)

Paramètres

message: String

Obligatoire. Message à consigner. Si message est Nothing, une chaîne vide est utilisée.

severity: TraceEventType

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

id: Int32

Identificateur de message, utilisé en général pour la corrélation. Par défaut, lié à entryType comme décrit dans le tableau.

Exceptions

InvalidEnumArgumentException

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

SecurityException

Le code d'un niveau de confiance partiel appelle la méthode, mais effectue l'écriture dans un écouteur de journal des événements qui requiert une confiance totale.

Exemples

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 peut s’exécuter uniquement dans une application cliente. Remplacez par My.Application.Log.WriteEntryMy.Log.WriteEntry pour les applications web.

Remarques

La WriteEntry méthode écrit un message dans les écouteurs du journal des événements de l’application.

Dans les applications clientes, l’objet Log est disponible via l’objet My.Application.Log . Dans les applications web, l’objet Log est disponible via l’objet My.Log .

Pour les surcharges qui ne prennent pas l’argument id , l’écrit id dans le journal est défini par le tableau suivant.

`severity`	Par défaut `id`
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

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

À	Consultez
Écrire des informations sur les événements dans les écouteurs de journal de l’application	Procédure : écrire des messages de journal
Déterminer où `Log` écrit les informations	Procédure pas à pas : détermination de l’emplacement des informations My.Application.Log

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

Voir aussi

S’applique à

Partager via

Log.WriteEntry Méthode

Définition

Surcharges

WriteEntry(String)

Paramètres

Exceptions

Exemples

Remarques

Disponibilité par type de projet

Voir aussi

S’applique à

WriteEntry(String, TraceEventType)

Paramètres

Exceptions

Exemples

Remarques

Disponibilité par type de projet

Voir aussi

S’applique à

WriteEntry(String, TraceEventType, Int32)

Paramètres

Exceptions

Exemples

Remarques

Disponibilité par type de projet

Voir aussi

S’applique à

Ressources supplémentaires