Log.WriteEntry Méthode

Définition

Espace de noms:: Microsoft.VisualBasic.Logging

Assembly:: Microsoft.VisualBasic.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 journal de l’application.

Surcharges

Nom	Description
WriteEntry(String)	Écrit un message dans les écouteurs de journal de l’application.
WriteEntry(String, TraceEventType)	Écrit un message dans les écouteurs de journal de l’application.
WriteEntry(String, TraceEventType, Int32)	Écrit un message dans les écouteurs de journal de l’application.

WriteEntry(String)

Écrit un message dans les écouteurs de journal 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

Required. Message à consigner. Si message c’est Nothingle cas, une chaîne vide est utilisée.

Exceptions

SecurityException

Le code avec approbation partielle appelle la méthode, mais écrit dans un écouteur du journal des événements qui nécessite une confiance totale.

Exemples

Cet exemple montre comment utiliser la My.Application.Log.WriteEntry méthode pour journaliser les informations de suivi. Pour plus d’informations, consultez Guide pratique pour écrire des messages de journal.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            ' Use a thread-safe method to get all form titles.
            formTitles.Add(GetFormTitle(f))
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Private Delegate Function GetFormTitleDelegate(f As Form) As String
Private Function GetFormTitle(f As Form) As String
    ' Check if the form can be accessed from the current thread.
    If Not f.InvokeRequired Then
        ' Access the form directly.
        Return f.Text
    Else
        ' Marshal to the thread that owns the form. 
        Dim del As GetFormTitleDelegate = AddressOf GetFormTitle
        Dim param As Object() = {f}
        Dim result As System.IAsyncResult = f.BeginInvoke(del, param)
        ' Give the form's thread a chance process function.
        System.Threading.Thread.Sleep(10)
        ' Check the result.
        If result.IsCompleted Then
            ' Get the function's return value.
            Return "Different thread: " & f.EndInvoke(result).ToString
        Else
            Return "Unresponsive thread"
        End If
    End If
End Function

Cet exemple de code ne peut s’exécuter qu’au sein d’une application cliente. Passez My.Application.Log.WriteEntry à My.Log.WriteEntry des 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’activité des applications.

Pour les surcharges qui ne prennent pas l’argument id , l’écriture id dans le journal est définie 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

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	Guide pratique pour écrire des messages de journal
Déterminer où `Log` écrit des informations	Procédure pas à pas : détermination de l’emplacement où My.Application.Log écrit des informations

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Yes
Bibliothèque de classes	Yes
Application console	Yes
Bibliothèque de contrôles Windows	Yes
Bibliothèque de contrôles web	Non
Service Windows	Yes
Site Web	Yes

Voir aussi

S’applique à

WriteEntry(String, TraceEventType)

Écrit un message dans les écouteurs de journal 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

Required. Message à consigner. Si message c’est Nothingle cas, une chaîne vide est utilisée.

severity: TraceEventType

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

Exceptions

InvalidEnumArgumentException

Le type de message n’est pas l’une des valeurs d’énumération TraceEventType .

SecurityException

Le code avec approbation partielle appelle la méthode, mais écrit dans un écouteur du journal des événements qui nécessite une confiance totale.

Exemples

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            ' Use a thread-safe method to get all form titles.
            formTitles.Add(GetFormTitle(f))
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Private Delegate Function GetFormTitleDelegate(f As Form) As String
Private Function GetFormTitle(f As Form) As String
    ' Check if the form can be accessed from the current thread.
    If Not f.InvokeRequired Then
        ' Access the form directly.
        Return f.Text
    Else
        ' Marshal to the thread that owns the form. 
        Dim del As GetFormTitleDelegate = AddressOf GetFormTitle
        Dim param As Object() = {f}
        Dim result As System.IAsyncResult = f.BeginInvoke(del, param)
        ' Give the form's thread a chance process function.
        System.Threading.Thread.Sleep(10)
        ' Check the result.
        If result.IsCompleted Then
            ' Get the function's return value.
            Return "Different thread: " & f.EndInvoke(result).ToString
        Else
            Return "Unresponsive thread"
        End If
    End If
End Function

Cet exemple de code ne peut s’exécuter qu’au sein d’une application cliente. Passez My.Application.Log.WriteEntry à My.Log.WriteEntry des 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’écriture id dans le journal est définie 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

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	Guide pratique pour écrire des messages de journal
Déterminer où `Log` écrit des informations	Procédure pas à pas : détermination de l’emplacement où My.Application.Log écrit des informations

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Yes
Bibliothèque de classes	Yes
Application console	Yes
Bibliothèque de contrôles Windows	Yes
Bibliothèque de contrôles web	Non
Service Windows	Yes
Site Web	Yes

Voir aussi

S’applique à

WriteEntry(String, TraceEventType, Int32)

Écrit un message dans les écouteurs de journal 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

Required. Message à consigner. Si message c’est Nothingle cas, une chaîne vide est utilisée.

severity: TraceEventType

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

id: Int32

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

Exceptions

InvalidEnumArgumentException

Le type de message n’est pas l’une des valeurs d’énumération TraceEventType .

SecurityException

Le code avec approbation partielle appelle la méthode, mais écrit dans un écouteur du journal des événements qui nécessite une confiance totale.

Exemples

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            ' Use a thread-safe method to get all form titles.
            formTitles.Add(GetFormTitle(f))
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Private Delegate Function GetFormTitleDelegate(f As Form) As String
Private Function GetFormTitle(f As Form) As String
    ' Check if the form can be accessed from the current thread.
    If Not f.InvokeRequired Then
        ' Access the form directly.
        Return f.Text
    Else
        ' Marshal to the thread that owns the form. 
        Dim del As GetFormTitleDelegate = AddressOf GetFormTitle
        Dim param As Object() = {f}
        Dim result As System.IAsyncResult = f.BeginInvoke(del, param)
        ' Give the form's thread a chance process function.
        System.Threading.Thread.Sleep(10)
        ' Check the result.
        If result.IsCompleted Then
            ' Get the function's return value.
            Return "Different thread: " & f.EndInvoke(result).ToString
        Else
            Return "Unresponsive thread"
        End If
    End If
End Function

Cet exemple de code ne peut s’exécuter qu’au sein d’une application cliente. Passez My.Application.Log.WriteEntry à My.Log.WriteEntry des 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’écriture id dans le journal est définie 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

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	Guide pratique pour écrire des messages de journal
Déterminer où `Log` écrit des informations	Procédure pas à pas : détermination de l’emplacement où My.Application.Log écrit des informations

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Yes
Bibliothèque de classes	Yes
Application console	Yes
Bibliothèque de contrôles Windows	Yes
Bibliothèque de contrôles web	Non
Service Windows	Yes
Site Web	Yes

Voir aussi

S’applique à

Commentaires

Est-ce que cette page vous a été utile?