Throw, exemple
Les exceptions fournissent une manière structurée, uniforme et de type sécurisé pour gérer des conditions de workflow, de portée et d'erreur au niveau utilisateur. Le mécanisme d'exception dans Windows Workflow Foundation est similaire à celui dans C#. Il permet à un développeur de lever des exceptions, de les intercepter par type et d'assigner des exceptions à une variable.
Cet exemple indique comment un workflow peut modéliser et lever une exception, et comment cette exception est traitée par l'application d'hébergement. L'exemple utilise une activité ThrowActivity pour lever une exception Exception. Comme aucun gestionnaire d'exceptions n'est défini dans le workflow, l'exception s'échappe du workflow et ce dernier s'arrête. Comme le workflow est exécuté de façon asynchrone, les informations sur les exceptions sont envoyées à l'application hôte via WorkflowTerminatedEventArgs dans l'événement WorkflowTerminated.
Lorsque vous utilisez l'activité ThrowActivity, vous avez la possibilité de spécifier le type de l'exception à lever et d'assigner ce type à la propriété FaultType ou d'instancier un objet d'exception et d'assigner cette instance à la propriété Fault. Lorsque vous utilisez la propriété FaultType, l'activité ThrowActivity crée une instance de ce type d'exception lorsque l'exception est levée. Utilisez cette méthode si vous souhaitez lever une exception générique ou dans le cas d'un scénario de création entièrement déclaratif. Pour fournir des informations sur les exceptions plus concrètes et plus nombreuses, créez une instance d'un objet d'exception et assignez-la à la propriété Fault de l'activité ThrowActivity. Cet exemple illustre cette méthode.
Remarque : |
---|
Le recours à l'activité ThrowActivity revient à lever une exception à partir d'un gestionnaire de code ou depuis le code d'exécution d'une activité ; toutefois, l'utilisation de l'activité ThrowActivity permet à l'auteur du workflow de modéliser explicitement la levée d'exceptions dans un workflow. |
Pour générer l'exemple
Téléchargez l'exemple en cliquant sur Télécharger l'exemple dans cette rubrique.
L'exemple de projet est alors extrait sur votre disque dur local.
Cliquez sur Démarrer, pointez sur Programmes, puis sur Microsoft Windows SDK et cliquez sur Environnement de commande.
Accédez au répertoire source de l'exemple.
À l'invite de commandes, tapez MSBUILD <Nom du fichier solution>.
Pour exécuter l'exemple
- Dans la fenêtre Invite de commandes du Kit de développement SDK, exécutez le fichier .exe dans le dossier Throw\bin\debug (ou le dossier Throw\bin pour la version VB de l'exemple), situé sous le dossier principal de l'exemple.
Voir aussi
Référence
Autres ressources
Using the ThrowActivity Activity
Nested Exception Handlers, exemple
Fault Handling in Workflows
Exemples d'activités
Copyright ©2007 par Microsoft Corporation. Tous droits réservés.