WindowsFormsApplicationBase.UnhandledException Événement

  • Référence

Définition

Espace de noms:
Microsoft.VisualBasic.ApplicationServices
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.dll

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

UnhandledExceptionEventHandler

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 Code Rédacteur 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 Code Rédacteur pour les événements d’application
1. Avec un projet sélectionné dans 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 le code Rédacteur.

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

S’applique à

Voir aussi