Exceptions personnalisées, exemple

Article
08/21/2008

Mise à jour : novembre 2007

Cette solution illustre deux techniques plus avancées de gestion des exceptions : gestion des exceptions personnalisées et gestion globale des exceptions.

Pour obtenir des exemples et leurs instructions d'installation

Effectuez une ou plusieurs des opérations suivantes :
- Dans le menu ? (Aide), cliquez sur Exemples.
  
  Le fichier Readme contient des informations sur les exemples.
- Accédez au site Web Exemples Visual Studio 2008. La version la plus récente des exemples est disponible sur ce site.
- Recherchez les exemples sur l'ordinateur sur lequel Visual Studio est installé. Par défaut, les exemples et un fichier Readme sont installés sous lecteur:\Program Files\Microsoft Visual Studio 9.0\Samples\1036. Pour les versions Express de Visual Studio, tous les exemples sont disponibles en ligne.

Pour plus d'informations, consultez Recherche des fichiers d'exemple.

Note de sécurité :
Cet exemple de code est destiné à illustrer un concept ; il présente uniquement le code qui se rapporte spécifiquement à ce concept. Il est possible qu'il ne réponde pas aux exigences de sécurité d'un environnement spécifique, et ne doit pas être utilisé exactement comme indiqué. Nous vous recommandons d'ajouter du code de sécurité et de gestion des erreurs afin de renforcer la sécurité et la fiabilité de vos projets. Microsoft fournit cet exemple de code « EN L'ÉTAT » sans aucune garantie.

Cet exemple de code est destiné à illustrer un concept ; il présente uniquement le code qui se rapporte spécifiquement à ce concept. Il est possible qu'il ne réponde pas aux exigences de sécurité d'un environnement spécifique, et ne doit pas être utilisé exactement comme indiqué. Nous vous recommandons d'ajouter du code de sécurité et de gestion des erreurs afin de renforcer la sécurité et la fiabilité de vos projets. Microsoft fournit cet exemple de code « EN L'ÉTAT » sans aucune garantie.

Pour exécuter cet exemple

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet Client, puis sélectionnez Définir comme projet de démarrage.
Appuyez sur la combinaison de touches CTRL+F5. Le programme est le mieux exécuté à l'extérieur du débogueur pour consulter les effets d'un gestionnaire d'exceptions global.

Démonstrations

Cet exemple contient deux projets : un client Windows Forms et une bibliothèque de classes.

Bibliothèque de classes (serveur)

La bibliothèque de classes définit la classe Customer ainsi qu'un ensemble de classes d'exceptions personnalisées qui sont utilisées pour exposer des erreurs définies par l'application. Les classes d'exceptions sont liées par une hiérarchie d'héritage. La classe de base est CRMSystemException, laquelle hérite de ApplicationException. CustomerException et EmployeeException héritent de CRMSystemException. Il existe deux exceptions supplémentaires héritant de CustomerException:CustomerNotFoundException et CustomerNotDeletedException. Chaque classe expose différents niveaux d'informations et de fonctionnalités.

Code Client

L'application cliente fait référence à la bibliothèque de classes. Deux boutons de commande exécutent des méthodes sur la classe Customer et interceptent les exceptions personnalisées. Un troisième bouton de commande génère une exception non gérée. De plus, la case à cocher étiquetée "Turn on Global Exception Trap" active une interruption d'exception globale. Si vous activez cette case à cocher, le code défini dans la méthode OnThreadException sera exécuté à la place du gestionnaire Windows Forms par défaut.