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.
Se produit lorsque 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 consigner 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 page Application, Concepteur de projets (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 qui a provoqué cet événement.
Vous pouvez utiliser la ExitApplication propriété du e paramètre pour contrôler si l’application quitte. Par défaut, ExitApplication est True. Par conséquent, l’application se ferme après avoir terminé le UnhandledException gestionnaire d’événements. Vous pouvez définir la valeur False dans le UnhandledException gestionnaire d’événements pour que l’application reste en cours d’exécution et qu’elle retourne à 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 page Application, Concepteur de projets (Visual Basic).
Note
Le compilateur Visual Basic empêche les applications créées pour le débogage de déclencher cet événement, afin d’activer un débogueur pour gérer les exceptions non gérées. Cela signifie que si vous testez votre application en l’exécutant sous le débogueur de l’environnement de développement intégré Visual Studio, votre UnhandledException gestionnaire d’événements ne sera 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 |
|---|---|
| Consigner les exceptions non gérées | Guide pratique pour consigner des exceptions |
Disponibilité par type de projet
| Type de projet | Disponible |
|---|---|
| Windows Forms Application | Oui |
| Bibliothèque de classes | Non |
| Console Application | Non |
| Bibliothèque de contrôles Windows Forms | Non |
| Bibliothèque de contrôles web | Non |
| Service Windows | Non |
| Site Web | Non |
