My.Application.UnhandledException, événement

Mise à jour : Juillet 2008

Se produit lorsque l'application rencontre une exception non gérée.

' Usage
Public Sub Me_UnhandledException( _
   ByVal sender As Object, _
   ByVal e As UnhandledExceptionEventArgs _
) Handles Me.UnhandledException
End Sub
' Declaration
Public Event UnhandledException( _
   ByVal sender As Object, _
   ByVal e As UnhandledExceptionEventArgs _
)

Paramètres

• sender
  Objet Object qui a déclenché l'événement.

• e
  Objet UnhandledExceptionEventArgs qui contient l'exception non gérée et des informations supplémentaires.

Notes

Une application déclenche l'événement UnhandledException lorsqu'elle rencontre une exception non gérée. Cet événement fait partie du modèle d'application Visual Basic. Pour plus d'informations, consultez Vue d'ensemble du modèle d'application Visual Basic.

Vous pouvez utiliser la propriété Exception du paramètre e pour accéder à l'exception non gérée qui a provoqué cet événement.

Vous pouvez utiliser la propriété ExitApplication du paramètre e pour contrôler la fermeture de l'application. Étant donné que ExitApplication a la valeur True par défaut, l'application se ferme après l'exécution du gestionnaire d'événements UnhandledException. Vous pouvez lui affecter False dans le gestionnaire d'événements UnhandledException pour que l'application continue à fonctionner, et la rétablir dans un état d'attente.

Le code du gestionnaire d'événements UnhandledException est stocké dans le fichier ApplicationEvents.vb, qui est masqué par défaut.

Pour accéder à la fenêtre de l'éditeur de code pour les événements d'application :

1. Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet sur Propriétés.

2. Cliquez sur l'onglet Application.

3. Cliquez sur le bouton Afficher les événements de l'application pour ouvrir l'éditeur de code.

Pour plus d'informations, consultez Comment : gérer les événements d'application (Visual Basic).

Remarque :

Le compilateur Visual Basic empêche les applications générées pour le débogage de déclencher cet événement, afin de permettre à un débogueur de gérer les exceptions non gérées. Cela signifie que si vous testez votre application en l'exécutant dans le débogueur Environnement de développement intégré de Visual Studio, votre gestionnaire d'événements UnhandledException ne sera pas appelé. Pour plus d'informations sur la génération d'applications pour le débogage, consultez /debug (Visual Basic).

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant l'événement My.Application.UnhandledException.

Exemple

Cet exemple utilise l'événement My.Application.UnhandledException pour enregistrer les exceptions non gérées.

Private Sub MyApplication_UnhandledException( _
    ByVal sender As Object, _
    ByVal e As Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventArgs _
) Handles Me.UnhandledException
    My.Application.Log.WriteException(e.Exception, _
        TraceEventType.Critical, _
        "Unhandled Exception.")
End Sub

Vous devez entrer le code dans la fenêtre de l'éditeur de code pour les événements d'application. Pour accéder à cette fenêtre, suivez la procédure indiquée dans la section Notes de cette rubrique. Pour plus d'informations, consultez Comment : gérer les événements d'application (Visual Basic).

Étant donné que l'événement UnhandledException n'est pas déclenché lorsqu'un débogueur est associé à l'application, vous devez exécuter cet exemple en dehors du débogueur Environnement de développement intégré de Visual Studio.

Configuration requise

Espace de noms :Microsoft.VisualBasic.ApplicationServices

Classe :WindowsFormsApplicationBase

Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Autorisations

Les autorisations suivantes peuvent être nécessaires :

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

Voir aussi

Concepts

Vue d'ensemble du modèle d'application Visual Basic

Référence

My.Application, objet

Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventArgs

Historique des modifications