Log.WriteException 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 des informations d’exception dans les écouteurs de journal de l’application.

Surcharges

Nom	Description
WriteException(Exception)	Écrit des informations d’exception dans les écouteurs de journal de l’application.
WriteException(Exception, TraceEventType, String)	Écrit des informations d’exception dans les écouteurs de journal de l’application.
WriteException(Exception, TraceEventType, String, Int32)	Écrit des informations d’exception dans les écouteurs de journal de l’application.

WriteException(Exception)

Écrit des informations d’exception dans les écouteurs de journal de l’application.

public:
 void WriteException(Exception ^ ex);

public void WriteException(Exception ex);

member this.WriteException : Exception -> unit

Public Sub WriteException (ex As Exception)

Paramètres

ex: Exception

Required. Exception à journaliser.

Exceptions

ArgumentNullException

ex a la valeur Nothing.

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.WriteException méthode pour consigner des exceptions. Supprimez les Dim marques de commentaire et MsgBox les lignes pour provoquer une NullReferenceException exception. Pour plus d’informations, consultez Guide pratique pour enregistrer des exceptions.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Cet exemple de code ne peut s’exécuter qu’au sein d’une application cliente. Passez My.Application.Log.WriteException à My.Log.WriteException des applications web.

Remarques

La WriteException méthode écrit les informations contenues dans une exception 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 WriteException 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’identificateur é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

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

À	Consultez
Écrivez des informations sur les exceptions dans les écouteurs du journal des événements de l’application.	Guide pratique pour consigner des exceptions
Déterminez 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 à

WriteException(Exception, TraceEventType, String)

Écrit des informations d’exception dans les écouteurs de journal de l’application.

public:
 void WriteException(Exception ^ ex, System::Diagnostics::TraceEventType severity, System::String ^ additionalInfo);

public void WriteException(Exception ex, System.Diagnostics.TraceEventType severity, string additionalInfo);

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

Public Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String)

Paramètres

ex: Exception

Required. Exception à journaliser.

severity: TraceEventType

Type du message. Par défaut, Error.

additionalInfo: String

Chaîne à ajouter au message. Par défaut, il s’agit d’une chaîne vide.

Exceptions

ArgumentNullException

ex a la valeur Nothing.

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
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Cet exemple de code ne peut s’exécuter qu’au sein d’une application cliente. Passez My.Application.Log.WriteException à My.Log.WriteException des applications web.

Remarques

La WriteException méthode écrit les informations contenues dans une exception 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’identificateur é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

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

À	Consultez
Écrivez des informations sur les exceptions dans les écouteurs du journal des événements de l’application.	Guide pratique pour consigner des exceptions
Déterminez 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 à

WriteException(Exception, TraceEventType, String, Int32)

Écrit des informations d’exception dans les écouteurs de journal de l’application.

public:
 void WriteException(Exception ^ ex, System::Diagnostics::TraceEventType severity, System::String ^ additionalInfo, int id);

public void WriteException(Exception ex, System.Diagnostics.TraceEventType severity, string additionalInfo, int id);

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

Public Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String, id As Integer)

Paramètres

ex: Exception

Required. Exception à journaliser.

severity: TraceEventType

Type du message. Par défaut, Error.

additionalInfo: String

Chaîne à ajouter au message. Par défaut, il s’agit d’une chaîne vide.

id: Int32

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

Exceptions

ArgumentNullException

ex a la valeur Nothing.

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
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Cet exemple de code ne peut s’exécuter qu’au sein d’une application cliente. Passez My.Application.Log.WriteException à My.Log.WriteException des applications web.

Remarques

La WriteException méthode écrit les informations contenues dans une exception 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’identificateur é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

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

À	Consultez
Écrivez des informations sur les exceptions dans les écouteurs du journal des événements de l’application.	Guide pratique pour consigner des exceptions
Déterminez 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?