Partager via


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.

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.