WindowsFormsApplicationBase.UnhandledException Événement
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.
Survient si l'application rencontre une exception non gérée.
public:
event Microsoft::VisualBasic::ApplicationServices::UnhandledExceptionEventHandler ^ UnhandledException;public event Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventHandler UnhandledException;member this.UnhandledException : Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventHandler Public Custom Event UnhandledException As UnhandledExceptionEventHandler Type d'événement
Exemples
Cet exemple utilise l’événement My.Application.UnhandledException pour journaliser toutes les exceptions non gérées.
Vous devez entrer le code dans la fenêtre Éditeur de code pour les événements d’application. Pour accéder à cette fenêtre, suivez la procédure décrite dans la section Remarques de cette rubrique. Pour plus d'informations, consultez Application Page, Project Designer (Visual Basic).
Étant donné que l’événement UnhandledException n’est pas déclenché lorsqu’un débogueur est attaché à l’application, vous devez exécuter cet exemple en dehors de l’environnement de développement intégré Visual Studio.
Private Sub MyApplication_UnhandledException(
sender As Object,
e As Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventArgs
) Handles Me.UnhandledException
My.Application.Log.WriteException(e.Exception,
TraceEventType.Critical,
"Unhandled Exception.")
End Sub
Remarques
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 Exception propriété du e paramètre pour accéder à l’exception non gérée à l’origine de cet événement.
Vous pouvez utiliser la ExitApplication propriété du e paramètre pour contrôler si l’application se ferme. Par défaut, ExitApplication est True. Par conséquent, l’application se ferme une fois le gestionnaire d’événements UnhandledException terminé. Vous pouvez définir la valeur False sur dans le UnhandledException gestionnaire d’événements pour que l’application reste en cours d’exécution et la faire revenir à un état d’attente.
Le code du UnhandledException gestionnaire d’événements est stocké dans le fichier ApplicationEvents.vb, qui est masqué par défaut.
| Pour accéder à la fenêtre Éditeur de code pour les événements d’application |
| 1. Avec un projet sélectionné dans l’Explorateur de solutions, cliquez sur Propriétés dans le menu Projet . 2. Cliquez sur l’onglet Application. 3. Cliquez sur le bouton Afficher les événements d’application pour ouvrir l’éditeur de code. |
Pour plus d'informations, consultez Application Page, Project Designer (Visual Basic).
Notes
Le compilateur Visual Basic empêche les applications créées pour le débogage de déclencher cet événement, pour 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 sous le débogueur Visual Studio Integrated Development Environment, votre UnhandledException gestionnaire d’événements n’est pas appelé. Pour plus d’informations sur la création d’applications pour le débogage, consultez /debug (Visual Basic).
Tâches
Le tableau suivant répertorie des exemples de tâches qui impliquent l’événement My.Application.UnhandledException .
| À | Consultez |
|---|---|
| Journaliser les exceptions non gérées | Procédure : journaliser des exceptions |
Disponibilité par type de projet
| Type de projet | Disponible |
|---|---|
| Application Windows Forms | Oui |
| Bibliothèque de classes | Non |
| Application console | Non |
| Bibliothèque de contrôles Windows Forms | Non |
| Bibliothèque de contrôles web | Non |
| Service Windows | Non |
| Site web | Non |
