Log.WriteEntry Méthode

Définition

Écrit un message dans les écouteurs de journalisation de l'application.Writes a message to the application's log listeners.

Surcharges

WriteEntry(String)

Écrit un message dans les écouteurs de journalisation de l'application.Writes a message to the application's log listeners.

WriteEntry(String, TraceEventType)

Écrit un message dans les écouteurs de journalisation de l'application.Writes a message to the application's log listeners.

WriteEntry(String, TraceEventType, Int32)

Écrit un message dans les écouteurs de journalisation de l'application.Writes a message to the application's log listeners.

WriteEntry(String)

Écrit un message dans les écouteurs de journalisation de l'application.Writes a message to the application's log listeners.

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.Required. Message à consigner.The message to log. Si message est Nothing, une chaîne vide est utilisée.If message is Nothing, an empty string is used.

Exceptions

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.Code with partial trust calls the method, but writes to an event log listener that requires full trust.

Exemples

Cet exemple montre comment utiliser la méthode My.Application.Log.WriteEntry pour enregistrer des informations de traçage.This example shows how to use the My.Application.Log.WriteEntry method to log tracing information. Pour plus d’informations, consultez Comment : écrire des messages de journal.For more information, see How to: Write Log Messages.

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.This code example can run only within a client application. Remplacez My.Application.Log.WriteEntry My.Log.WriteEntry par pour les applications Web.Change My.Application.Log.WriteEntry to My.Log.WriteEntry for Web applications.

Remarques

La WriteEntry méthode écrit un message dans les écouteurs de journalisation des événements de l’application.The WriteEntry method writes a message to the application's event log listeners.

Dans les applications clientes, l' Log objet est disponible via l' My.Application.Log objet.In client applications, the Log object is available through the My.Application.Log object. Dans les applications Web, l' Log objet est disponible via l' My.Log objet.In Web applications, the Log object is available through the My.Log object.

Pour connaître les écouteurs de journalisation qui reçoivent les WriteEntry messages de la méthode, consultez procédure pas à pas : détermination de l’emplacement des informations My. application. log.To learn which log listeners receive the WriteEntry method's messages, see Walkthrough: Determining Where My.Application.Log Writes Information. Vous pouvez modifier les écouteurs de journalisation par défaut.You can change default log listeners. Pour plus d’informations, consultez Utilisation des journaux d’application.For more information, see Working with Application Logs.

Pour les surcharges qui ne prennent pas l' id argument, le id écrit dans le journal est défini par le tableau suivant.For overloads that do not take the id argument, the id written to the log is defined by the following table.

severity Valeurs idDefault id
Information 00
Warning 11
Error 22
Critical 33
Start 44
Stop 55
Suspend 66
Resume 77
Verbose 88
Transfer 99

Le tableau suivant répertorie des exemples de tâches impliquant la WriteEntry méthode.The following table lists examples of tasks involving the WriteEntry method.

ÀTo ConsultezSee
Écrire des informations sur les événements dans les écouteurs de journalisation de l’applicationWrite event information to the application's log listeners Procédure : écrire des messages de journalHow to: Write Log Messages
Déterminer où Log écrit les informationsDetermine where Log writes information Procédure pas à pas : détermination de l’emplacement des informations My.Application.LogWalkthrough: Determining Where My.Application.Log Writes Information

Disponibilité par type de projetAvailability by Project Type

Type de projetProject type DisponibleAvailable
Application WindowsWindows Application OuiYes
Bibliothèque de classesClass Library OuiYes
Application consoleConsole Application OuiYes
Bibliothèque de contrôles WindowsWindows Control Library OuiYes
Bibliothèque de contrôles WebWeb Control Library NonNo
Service WindowsWindows Service OuiYes
Site webWeb Site OuiYes

Voir aussi

S’applique à

WriteEntry(String, TraceEventType)

Écrit un message dans les écouteurs de journalisation de l'application.Writes a message to the application's log listeners.

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.Required. Message à consigner.The message to log. Si message est Nothing, une chaîne vide est utilisée.If message is Nothing, an empty string is used.

severity
TraceEventType

Type de message.The type of message. Par défaut, TraceEventType.Information.By default, TraceEventType.Information.

Exceptions

Le type de message ne fait pas partie des valeurs de l'énumération TraceEventType.The message type is not one of the TraceEventType enumeration values.

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.Code with partial trust calls the method, but writes to an event log listener that requires full trust.

Exemples

Cet exemple montre comment utiliser la méthode My.Application.Log.WriteEntry pour enregistrer des informations de traçage.This example shows how to use the My.Application.Log.WriteEntry method to log tracing information. Pour plus d’informations, consultez Comment : écrire des messages de journal.For more information, see How to: Write Log Messages.

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.This code example can run only within a client application. Remplacez My.Application.Log.WriteEntry My.Log.WriteEntry par pour les applications Web.Change My.Application.Log.WriteEntry to My.Log.WriteEntry for Web applications.

Remarques

La WriteEntry méthode écrit un message dans les écouteurs de journalisation des événements de l’application.The WriteEntry method writes a message to the application's event log listeners.

Dans les applications clientes, l' Log objet est disponible via l' My.Application.Log objet.In client applications, the Log object is available through the My.Application.Log object. Dans les applications Web, l' Log objet est disponible via l' My.Log objet.In Web applications, the Log object is available through the My.Log object.

Pour connaître les écouteurs de journalisation qui reçoivent les WriteEntry messages de la méthode, consultez procédure pas à pas : détermination de l’emplacement des informations My. application. log.To learn which log listeners receive the WriteEntry method's messages, see Walkthrough: Determining Where My.Application.Log Writes Information. Vous pouvez modifier les écouteurs de journalisation par défaut.You can change default log listeners. Pour plus d’informations, consultez Utilisation des journaux d’application.For more information, see Working with Application Logs.

Pour les surcharges qui ne prennent pas l' id argument, le id écrit dans le journal est défini par le tableau suivant.For overloads that do not take the id argument, the id written to the log is defined by the following table.

severity Valeurs idDefault id
Information 00
Warning 11
Error 22
Critical 33
Start 44
Stop 55
Suspend 66
Resume 77
Verbose 88
Transfer 99

Le tableau suivant répertorie des exemples de tâches impliquant la WriteEntry méthode.The following table lists examples of tasks involving the WriteEntry method.

ÀTo ConsultezSee
Écrire des informations sur les événements dans les écouteurs de journalisation de l’applicationWrite event information to the application's log listeners Procédure : écrire des messages de journalHow to: Write Log Messages
Déterminer où Log écrit les informationsDetermine where Log writes information Procédure pas à pas : détermination de l’emplacement des informations My.Application.LogWalkthrough: Determining Where My.Application.Log Writes Information

Disponibilité par type de projetAvailability by Project Type

Type de projetProject type DisponibleAvailable
Application WindowsWindows Application OuiYes
Bibliothèque de classesClass Library OuiYes
Application consoleConsole Application OuiYes
Bibliothèque de contrôles WindowsWindows Control Library OuiYes
Bibliothèque de contrôles WebWeb Control Library NonNo
Service WindowsWindows Service OuiYes
Site webWeb Site OuiYes

Voir aussi

S’applique à

WriteEntry(String, TraceEventType, Int32)

Écrit un message dans les écouteurs de journalisation de l'application.Writes a message to the application's log listeners.

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.Required. Message à consigner.The message to log. Si message est Nothing, une chaîne vide est utilisée.If message is Nothing, an empty string is used.

severity
TraceEventType

Type de message.The type of message. Par défaut, TraceEventType.Information.By default, TraceEventType.Information.

id
Int32

Identificateur de message, utilisé en général pour la corrélation.Message identifier, typically used for correlation. Par défaut, associé à entryType comme décrit dans le tableau.By default, related to entryType as described in the table.

Exceptions

Le type de message ne fait pas partie des valeurs de l'énumération TraceEventType.The message type is not one of the TraceEventType enumeration values.

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.Code with partial trust calls the method, but writes to an event log listener that requires full trust.

Exemples

Cet exemple montre comment utiliser la méthode My.Application.Log.WriteEntry pour enregistrer des informations de traçage.This example shows how to use the My.Application.Log.WriteEntry method to log tracing information. Pour plus d’informations, consultez Comment : écrire des messages de journal.For more information, see How to: Write Log Messages.

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.This code example can run only within a client application. Remplacez My.Application.Log.WriteEntry My.Log.WriteEntry par pour les applications Web.Change My.Application.Log.WriteEntry to My.Log.WriteEntry for Web applications.

Remarques

La WriteEntry méthode écrit un message dans les écouteurs de journalisation des événements de l’application.The WriteEntry method writes a message to the application's event log listeners.

Dans les applications clientes, l' Log objet est disponible via l' My.Application.Log objet.In client applications, the Log object is available through the My.Application.Log object. Dans les applications Web, l' Log objet est disponible via l' My.Log objet.In Web applications, the Log object is available through the My.Log object.

Pour connaître les écouteurs de journalisation qui reçoivent les WriteEntry messages de la méthode, consultez procédure pas à pas : détermination de l’emplacement des informations My. application. log.To learn which log listeners receive the WriteEntry method's messages, see Walkthrough: Determining Where My.Application.Log Writes Information. Vous pouvez modifier les écouteurs de journalisation par défaut.You can change default log listeners. Pour plus d’informations, consultez Utilisation des journaux d’application.For more information, see Working with Application Logs.

Pour les surcharges qui ne prennent pas l' id argument, le id écrit dans le journal est défini par le tableau suivant.For overloads that do not take the id argument, the id written to the log is defined by the following table.

severity Valeurs idDefault id
Information 00
Warning 11
Error 22
Critical 33
Start 44
Stop 55
Suspend 66
Resume 77
Verbose 88
Transfer 99

Le tableau suivant répertorie des exemples de tâches impliquant la WriteEntry méthode.The following table lists examples of tasks involving the WriteEntry method.

ÀTo ConsultezSee
Écrire des informations sur les événements dans les écouteurs de journalisation de l’applicationWrite event information to the application's log listeners Procédure : écrire des messages de journalHow to: Write Log Messages
Déterminer où Log écrit les informationsDetermine where Log writes information Procédure pas à pas : détermination de l’emplacement des informations My.Application.LogWalkthrough: Determining Where My.Application.Log Writes Information

Disponibilité par type de projetAvailability by Project Type

Type de projetProject type DisponibleAvailable
Application WindowsWindows Application OuiYes
Bibliothèque de classesClass Library OuiYes
Application consoleConsole Application OuiYes
Bibliothèque de contrôles WindowsWindows Control Library OuiYes
Bibliothèque de contrôles WebWeb Control Library NonNo
Service WindowsWindows Service OuiYes
Site webWeb Site OuiYes

Voir aussi

S’applique à