Concepteur d'activités TryCatch
Le concepteur d’activités TryCatch permet de créer et configurer une activité TryCatch.
Activité TryCatch
L’activité TryCatch contient une activité Try, une collection Catch<TException> et une activité Finally. Un objet Catch<TException> de type TException contient une propriété ExceptionType et une propriété Action. Ensemble, ils permettent d'implémenter un mécanisme classique de gestion des erreurs basé sur les exceptions. Une activité TryCatch essaie d'exécuter son activité Try. Si l’activité Try lève une exception, l’activité TryCatch utilise sa collection Catch<TException> pour établir une correspondance avec l’exception. S’il existe une correspondance, la propriété Action du Catch<TException> correspondant est alors exécutée, en servant de logique de gestion des erreurs pour l’exception. Si les activités de la section Try s'achèvent correctement ou les activités de Catches s'achèvent correctement, l'activité TryCatch exécute son activité Finally. Pour plus d’informations, consultez Exceptions de workflow Windows.
Utilisation du concepteur d'activités TryCatch
Accédez au concepteur d’activités TryCatch dans la catégorie Gestion des erreurs de la boîte à outils.
Le concepteur d’activités TryCatch peut être déplacé de la Boîte à outils et déposé dans l’aire du Concepteur de flux de travail, là où les activités sont généralement placées, par exemple dans un Sequence. Cette opération crée une activité TryCatch avec une propriété DisplayName affectée de la valeur par défaut TryCatch. La valeur de la propriété DisplayName peut être modifiée dans l’en-tête du concepteur d’activités TryCatch ou dans la zone DisplayName de la grille des propriétés. Les autres propriétés doivent être modifiées dans l’aire du concepteur d’activités TryCatch.
Cliquez sur le bouton Développer dans le coin supérieur droit du concepteur TryCatch pour afficher les zones Try, Catches et Finally dans la vue développée. Pour ajouter un catch, cliquez sur le bouton Ajouter un nouveau catch dans le concepteur TryCatch. Le bouton se transforme en zone de liste déroulante Type. Sélectionnez un type d'exception et appuyez sur ENTRÉE pour ajouter le catch. Après l’ajout d’un élément Catch, la zone de catch se développe et une activité peut y être déposée pour définir la logique d’exécution du catch. Notez la présence d’une zone de texte à droite de la zone de catch développée. Vous pouvez nommer la variable d'exception à l'aide de cette zone de texte. La variable d’exception peut être utilisée uniquement pour les activités situées dans le même Catch.
Le concepteur TryCatch ne prend pas en charge la modification du Catch. Si vous souhaitez changer le type d’exception, vous devez supprimer le Catch et en ajouter un nouveau. Pour supprimer un Catch, sélectionnez-le puis supprimez-le, ou sélectionnez Supprimer dans le menu contextuel accessible par un clic droit.
Propriétés TryCatch
Le tableau suivant présente les propriétés de TryCatch et décrit comment elles sont utilisées dans le concepteur.
| Nom de la propriété | Obligatoire | Usage |
|---|---|---|
| DisplayName | False | Spécifie le nom convivial facultatif de l'activité TryCatch. TryCatch est la valeur par défaut. |
| Try | False | Première activité exécutée lorsque TryCatch s'exécute. |
| Catches | False | Collection d’éléments Catch à vérifier quand l’activité Try lève une exception. Vous devez au moins ajouter une activité dans Catches ou une activité dans le bloc Finally. |
| Finally | False | Activité à exécuter lorsque l'exécution de Try et de toutes les activités nécessaires de la collection Catches est terminée. Vous devez au moins ajouter une activité dans Catches ou une activité dans le bloc Finally. |