My.Application.UnhandledException, événement

Article
09/04/2008

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 :

Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet sur Propriétés.
Cliquez sur l'onglet Application.
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).

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.

Pour	Consultez
Utiliser les événements fournis par le modèle d'application Visual Basic pour exécuter le code	Comment : exécuter le code lorsque l'application démarre ou se termine
Enregistrer les exceptions non gérées	Comment : enregistrer des exceptions dans Visual Basic

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

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Non
Application console	Non
Bibliothèque de contrôles Windows	Non
Bibliothèque de contrôles Web	Non
Service Windows	Non
Site Web	Non

Autorisations

Les autorisations suivantes peuvent être nécessaires :

Autorisation	Description
SecurityPermission	Contrôle la capacité d'ajouter un gestionnaire d'événements pour cet événement. Énumération associée : SecurityPermissionFlag.ControlAppDomain.

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

Date	Historique	Raison
Juillet 2008	Informations révisées concernant la définition du gestionnaire d'événements UnhandledException dans la section Remarques.	Résolution des bogues de contenu.

Juillet 2008

Informations révisées concernant la définition du gestionnaire d'événements UnhandledException dans la section Remarques.

Résolution des bogues de contenu.

Partager via