Partager via


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 :

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.

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

Tâches

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

Pour

Reportez-vous à

Écrire les informations sur les exceptions dans les écouteurs des journaux des événements de l'application.

Comment : enregistrer des exceptions dans Visual Basic

Déterminer à quel emplacement Log écrit les informations.

Procédure pas à pas : détermination de l'emplacement des informations My.Application.Log

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

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

Autorisations

L'autorisation suivante peut être nécessaire :

Autorisation

Description

FileIOPermission

Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted.

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