Concepteur d'activités TryCatchTryCatch Activity Designer

Le TryCatch ActivityDesigner est utilisé pour créer et configurer un TryCatch activité.The TryCatch activity designer is used to create and configure a TryCatch activity.

Activité TryCatchThe TryCatch Activity

Le TryCatch activité contient un Try activité, une collection de Catch<TException > et un Finally activité.The TryCatch activity contains a Try activity, a collection of Catch<TException> and a Finally activity. Un Catch<TException> de type TException contient un ExceptionType et un Action.A Catch<TException> of type TException contains an ExceptionType and an Action. Ensemble, ils permettent d'implémenter un mécanisme classique de gestion des erreurs basé sur les exceptions.Together they are used to implement a typical exception-based error handling mechanism. Une activité TryCatch essaie d'exécuter son activité Try.A TryCatch activity tries to execute its Try activity. Si le Try activité lève une exception, le TryCatch activité utilise son intercepter < TException> collection pour correspondre à l’exception.If the Try activity throws any exception, the TryCatch activity uses its Catch<TException> collection to match the exception. S’il existe une correspondance, puis le Action correspondantes Catch<TException > est exécutée, servant à la gestion logique pour l’exception d’erreur.If there is a match, then the Action of the corresponding Catch<TException> is executed, serving as the error handling logic for the 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.If the activities in the Try section successfully complete or the activities in the Catches successfully complete, the TryCatch activity executes its Finally activity. Pour plus d’informations, consultez exceptions de flux de travail Windows.For more information, see Windows workflow exceptions.

Utilisation du concepteur d'activités TryCatchUsing the TryCatch Activity Designer

Accès le TryCatch Concepteur d’activités dans le gestion des erreurs catégorie de la boîte à outils.Access the TryCatch activity designer in the Error Handling category of the Toolbox.

Le TryCatch Concepteur d’activités peut être déplacé de la boîte à outils et déposés dans l’aire du Concepteur de flux de travail chaque fois que les activités sont généralement placées, par exemple dans un Sequence.The TryCatch activity designer can be dragged from the Toolbox and dropped on to the Workflow Designer surface wherever activities are usually placed, such as inside a Sequence. Cette opération crée une activité TryCatch avec une propriété DisplayName affectée de la valeur par défaut TryCatch.This creates a TryCatch activity with a default DisplayName of TryCatch. Le DisplayName valeur peut être modifiée dans l’en-tête de la TryCatch Concepteur d’activités ou dans le DisplayName case de la grille des propriétés.The DisplayName value can be edited in the header of the TryCatch activity designer or in the DisplayName box of the property grid. Les autres propriétés doivent être modifiées sur la surface de la TryCatch Concepteur d’activités.The other properties must be edited on the surface of the TryCatch activity designer.

Cliquez sur le bouton développer dans le coin supérieur droit de TryCatch concepteur pour afficher la essayez, intercepte, et enfin zones dans le vue développée.Click the expand button on the right top corner of TryCatch designer to see the Try, Catches, and Finally boxes in the expanded view. Pour ajouter un bloc catch, cliquez sur le ajouter un nouveau catch bouton sur TryCatch concepteur.To add a catch, click the Add new catch button on TryCatch designer. Le bouton se transforme en zone de liste déroulante Type.The button changes to a type combo box. Sélectionnez un type d'exception et appuyez sur ENTRÉE pour ajouter le catch.Select an exception type and press ENTER to add the catch. Après avoir ajouté un Catch, la zone de catch se développe et une activité peut être déposée dans le bloc catch pour définir la logique d’exécution de l’interception.After adding a Catch, the catch area expands and an activity can be dropped into the catch to define the execution logic for the catch. Notez la présence d’une zone de texte à droite de la zone de catch développée.Note that there is a text box on the right side of the expanded catch area. Vous pouvez nommer la variable d'exception à l'aide de cette zone de texte.You can name the exception variable using this text box. La variable d’exception peut uniquement être utilisée pour les activités au sein du même Catch.The exception variable can only be used for activities within the same Catch.

Le TryCatch concepteur ne prend pas en charge la modification Catch.The TryCatch designer does not support editing Catch. Si vous souhaitez modifier le type d’exception, vous devez supprimer le Catch et ajouter un nouveau.If you want to change the exception type, you have to delete the Catch and add a new one. Un Catch peut être supprimé en sélectionnant et en la supprimant ou en utilisant le supprimer menu sur le menu contextuel accédé par clic droit.A Catch can be deleted by selecting it and deleting it or by using the Delete menu on the context menu accessed by right clicking.

Propriétés TryCatchThe TryCatch Properties

Le tableau suivant présente le TryCatchpropriétés et décrit comment elles sont utilisées dans le concepteur.The following table shows the TryCatchproperties and describes how they are used in the designer.

Nom de la propriétéProperty Name ObligatoireRequired UtilisationUsage
DisplayName FalseFalse Spécifie le nom convivial facultatif de l'activité TryCatch.Specifies the optional friendly name of the TryCatch activity. TryCatch est la valeur par défaut.The default is TryCatch.
Try FalseFalse Première activité exécutée lorsque TryCatch s'exécute.The activity first executed when the TryCatch executes.
Catches FalseFalse La collection de Catch éléments à vérifier lorsque le Try activité lève une exception.The collection of Catch elements to be checked when the Try activity throws an exception.

Vous devez au moins ajouter une activité dans Catches ou une activité dans le bloc Finally.You need at least add one activity in Catches or an activity in the Finally block.
Finally FalseFalse Activité à exécuter lorsque l'exécution de Try et de toutes les activités nécessaires de la collection Catches est terminée.The activity to be executed when the Try and any necessary activities in the Catches collection complete execution.

Vous devez au moins ajouter une activité dans Catches ou une activité dans le bloc Finally.You need at least add one activity in Catches or an activity in the Finally block.

Voir aussiSee also