Log.WriteException Méthode
Définition
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 sur les exceptions dans les écouteurs de journalisation de l'application.
Surcharges
| WriteException(Exception) |
Écrit des informations sur les exceptions dans les écouteurs de journalisation de l'application. |
| WriteException(Exception, TraceEventType, String) |
Écrit des informations sur les exceptions dans les écouteurs de journalisation de l'application. |
| WriteException(Exception, TraceEventType, String, Int32) |
Écrit des informations sur les exceptions dans les écouteurs de journalisation de l'application. |
WriteException(Exception)
Écrit des informations sur les exceptions dans les écouteurs de journalisation de l'application.
public:
void WriteException(Exception ^ ex);public void WriteException (Exception ex);member this.WriteException : Exception -> unitPublic Sub WriteException (ex As Exception)Paramètres
- ex
- Exception
Obligatoire. Exception à enregistrer.
Exceptions
ex a la valeur Nothing.
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.
Exemples
Cet exemple montre comment utiliser la méthode pour consigner les My.Application.Log.WriteException exceptions. Supprimez les commentaires des lignes Dim et MsgBox pour déclencher une exception NullReferenceException. Pour plus d’informations, consultez Guide pratique pour journaliser les exceptions.
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. Accédez My.Application.Log.WriteException à My.Log.WriteException pour les 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’application.
Pour les surcharges qui ne prennent pas l’argument id , l’identificateur écrit dans le journal est défini par le tableau suivant.
severity |
Par défaut id |
|---|---|
| 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 d’exception dans les écouteurs du journal des événements de l’application. | Procédure : journaliser des exceptions |
Déterminer l’emplacement où Log écrit les informations. |
Procédure pas à pas : détermination de l’emplacement des informations My.Application.Log |
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 |
Voir aussi
- Exception
- TraceEventType
- Objets (Visual Basic)
- Utilisation des journaux des applications dans Visual Basic
- Guide pratique pour enregistrer des exceptions en Visual Basic
- Procédure pas à pas : détermination de l’emplacement des informations My.Application.Log
S’applique à
WriteException(Exception, TraceEventType, String)
Écrit des informations sur les exceptions dans les écouteurs de journalisation 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 -> unitPublic Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String)Paramètres
- ex
- Exception
Obligatoire. Exception à enregistrer.
- severity
- TraceEventType
Type de message. Par défaut, Error.
- additionalInfo
- String
Chaîne à ajouter au message. Par défaut, cette chaîne est vide.
Exceptions
ex a la valeur Nothing.
Le type de message ne fait pas partie des valeurs de l'énumération TraceEventType.
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.
Exemples
Cet exemple montre comment utiliser la méthode pour consigner les My.Application.Log.WriteException exceptions. Supprimez les commentaires des lignes Dim et MsgBox pour déclencher une exception NullReferenceException. Pour plus d’informations, consultez Guide pratique pour journaliser les exceptions.
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. Accédez My.Application.Log.WriteException à My.Log.WriteException pour les 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’application.
Pour les surcharges qui ne prennent pas l’argument id , l’identificateur écrit dans le journal est défini par le tableau suivant.
severity |
Par défaut id |
|---|---|
| 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 d’exception dans les écouteurs du journal des événements de l’application. | Procédure : journaliser des exceptions |
Déterminer l’emplacement où Log écrit les informations. |
Procédure pas à pas : détermination de l’emplacement des informations My.Application.Log |
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 |
Voir aussi
- Exception
- TraceEventType
- Objets (Visual Basic)
- Utilisation des journaux des applications dans Visual Basic
- Guide pratique pour enregistrer des exceptions en Visual Basic
- Procédure pas à pas : détermination de l’emplacement des informations My.Application.Log
S’applique à
WriteException(Exception, TraceEventType, String, Int32)
Écrit des informations sur les exceptions dans les écouteurs de journalisation 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 -> unitPublic Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String, id As Integer)Paramètres
- ex
- Exception
Obligatoire. Exception à enregistrer.
- severity
- TraceEventType
Type de message. Par défaut, Error.
- additionalInfo
- String
Chaîne à ajouter au message. Par défaut, cette chaîne est vide.
- id
- Int32
Identificateur de message, utilisé en général pour la corrélation. Par défaut, lié à entryType comme décrit dans le tableau de la section Remarques.
Exceptions
ex a la valeur Nothing.
Le type de message ne fait pas partie des valeurs de l'énumération TraceEventType.
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.
Exemples
Cet exemple montre comment utiliser la méthode pour consigner les My.Application.Log.WriteException exceptions. Supprimez les commentaires des lignes Dim et MsgBox pour déclencher une exception NullReferenceException. Pour plus d’informations, consultez Guide pratique pour journaliser les exceptions.
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. Accédez My.Application.Log.WriteException à My.Log.WriteException pour les 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’application.
Pour les surcharges qui ne prennent pas l’argument id , l’identificateur écrit dans le journal est défini par le tableau suivant.
severity |
Par défaut id |
|---|---|
| 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 d’exception dans les écouteurs du journal des événements de l’application. | Procédure : journaliser des exceptions |
Déterminer l’emplacement où Log écrit les informations. |
Procédure pas à pas : détermination de l’emplacement des informations My.Application.Log |
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 |
Voir aussi
- Exception
- TraceEventType
- Objets (Visual Basic)
- Utilisation des journaux des applications dans Visual Basic
- Guide pratique pour enregistrer des exceptions en Visual Basic
- Procédure pas à pas : détermination de l’emplacement des informations My.Application.Log
