WriteException, méthode (My.Application.Log et My.Log)

Mise à jour : novembre 2007

Écrit les informations sur les exceptions dans les écouteurs de journalisation de l'application.

' Usage
My.Application.Log.WriteException(ex)
My.Application.Log.WriteException(ex ,severity ,additionalInfo)
My.Application.Log.WriteException(ex ,severity ,additionalInfo ,id)
' Web usage
My.Log.WriteException(ex)
My.Log.WriteException(ex ,severity ,additionalInfo)
My.Log.WriteException(ex ,severity ,additionalInfo ,id)
' Declaration
Public Sub WriteException( _
   ByVal ex As System.Exception _
)
' -or-
Public Sub WriteException( _
   ByVal ex As System.Exception, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal additionalInfo As String _
)
' -or-
Public Sub WriteException( _
   ByVal ex As System.Exception, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal additionalInfo As String, _
   ByVal id As Integer _
)

Paramètres

• ex
  Obligatoire. Exception à enregistrer.

• severity
  Type de message. Par défaut, Error.

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

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

Exceptions

Les conditions ci-dessous généreront une exception :

• l'exception ou le type de message est Nothing (ArgumentNullException) ;

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

• 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 (SecurityException).

Notes

La méthode WriteException écrit les informations contenues dans une exception dans les écouteurs des journaux des événements de l'application.

Dans les applications clientes, l'objet Log est disponible dans l'objet My.Application.Log. Dans les applications Web, l'objet Log est disponible dans l'objet My.Log.

Pour connaître les écouteurs de journalisation qui reçoivent les messages de la méthode WriteException, 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 ne prennent pas l'argument id, l'identificateur écrit dans le journal est défini par le tableau suivant.

Tâches

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

Exemple

Cet exemple indique comment utiliser la méthode My.Application.Log.WriteException pour enregistrer les exceptions. Supprimez les marques de commentaire des lignes Dim et MsgBox pour provoquer une exception NullReferenceException. Pour plus d'informations, consultez Comment : enregistrer des exceptions dans Visual Basic.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, _
            TraceEventType.Error, _
            "Exception in ExceptionLogTest " & _
            "with argument " & fileName & ".")
    End Try
End Sub

Cet exemple de code ne peut s'exécuter que dans une application cliente. Remplacez My.Application.Log.WriteException par My.Log.WriteException 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

Autorisations

L'autorisation suivante peut être nécessaire :

Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.

Voir aussi

Tâches

Comment : enregistrer des exceptions dans Visual Basic

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.Exception

System.Diagnostics.TraceEventType

Log.WriteException