Comment : utiliser l'Assistant Exception

L'Assistant Exception, qui apparaît toutes les fois qu'une exception d'exécution se produit, affiche le type d'exception, des conseils de résolution du problème et des remèdes. L'Assistant Exception peut également être utilisé pour afficher les détails d'un objet exception.

Une exception est un objet qui hérite de la classe Exception. Une exception est levée par le code lorsqu'un problème se produit ; elle remonte vers le haut de la pile jusqu'à ce que l'application la gère ou que le programme échoue.

Notes

Les options disponibles dans les boîtes de dialogue, ainsi que les noms et emplacements des commandes de menu que vous voyez, peuvent différer de ce qui est décrit dans l'aide selon vos paramètres actifs ou votre édition.Cette page d'aide concerne les Paramètres de développement généraux.Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils.Pour plus d'informations, consultez Paramètres Visual Studio.

Le tableau suivant répertorie et décrit les propriétés d'un objet exception. Ce qui apparaît dépend du type d'exception.

Propriété

Description

Données

Objet IDictionary qui contient des paires clé/valeur définies par l'utilisateur. La valeur par défaut est une collection vide.

FileName

Nom du fichier qui provoque l'exception.

FusionLog

Fichier journal qui décrit la raison pour laquelle un chargement d'assembly a échoué.

HelpLink

Lien au fichier d'aide associé à l'exception.

HResult

Valeur numérique codée assignée à une exception spécifique.

InnerException

Instance de Exception qui a généré l'exception en cours. Il est quelquefois utile d'intercepter une exception levée dans une routine d'assistance et de lever une nouvelle exception plus évocatrice de l'erreur, qui donne davantage d'informations. Dans de tels cas, l'exception d'origine est affectée à la propriété InnerException.

Message

Message associé à l'exception. Il s'affiche dans la langue spécifiée par la propriété CurrentUICulture du thread qui lève l'exception.

Source

Nom de l'application ou objet qui a provoqué l'exception. Si Source n'est pas défini, le nom retourné est celui de l'assembly dans lequel l'exception est survenue.

StackTrace

Représentation sous forme de chaîne des appels de méthodes de la pile des appels au moment où l'exception en cours a été levée. La trace de la pile comprend le nom du fichier source et le numéro de ligne du programme si les informations de débogage sont disponibles. StackTrace peut ne pas rapporter autant d'appels de méthodes que prévu, en raison des transformations de code qui se produisent lors de l'optimisation. La trace de la pile est capturée immédiatement avant qu'une exception soit levée.

TargetSite

Méthode qui lève l'exception actuelle. Si la méthode qui lève l'exception n'est pas disponible et si la trace de la pile n'est pas une référence nulle (Nothing en Visual Basic), TargetSite obtient la méthode de la trace de la pile. Si la trace de la pile est une référence nulle, TargetSite retourne également une référence nulle.

Pour en savoir plus sur un objet exception

  • Cliquez sur Afficher les détails dans le volet Actions. Une boîte de dialogue affiche les propriétés de l'exception.

Voir aussi

Tâches

Comment : mapper des HRESULT et des exceptions

Comment : corriger des erreurs d'exécution avec l'Assistant Exception

Référence

Assistant Exception, boîte de dialogue

Autres ressources

Choosing When to Use Structured and Unstructured Exception Handling

Gestion et levée des exceptions

How to: Check an Exception's Inner Exception