CancellationScope Activity Designer

The CancellationScope activity designer is used to create and configure a CancellationScope activity.

The CancellationScope Activity

The CancellationScope activity allows you to specify an activity for execution and cancellation logic for that activity.

Using the CancellationScope Activity Designer

The CancellationScope activity designer can be found in the Transaction category of the Toolbox, which is accessed by clicking the Toolbox tab of the Workflow Designer (Alternatively, select Toolbar from the View menu, or CTRL+ALT+X.)

The CancellationScope 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. This creates a CancellationScope activity with a default DisplayName of CancellationScope. The DisplayName value can be edited in the header of the CancellationScope activity designer or in the DisplayName box of the property grid.

The CancellationScope Properties

The following table shows the CancellationScope properties and describes how they are used in the designer. The DisplayName property can be edited in property grid but the other properties must be edited on Workflow Designer surface.

Property Name Required Usage

DisplayName

False

The optional friendly name of the CancellationScope activity. The default is CancellationScope. Although the DisplayName value is not strictly required, it is a best practice to use one.

Body

True

Specifies the activity for which cancellation logic is provided. To add the Body activity, drop an activity from the Toolbox into the Body box on the CancellationScope activity designer with hint text “Drop Activity Here”.

CancellationHandler

True

Specifies the activity that is executed in the event of cancellation. To add the CancellationHandler activity, drop an activity from the Toolbox into the CancellationHandler box on the CancellationScope activity designer with hint text “Drop Activity Here”.

See Also

Concepts

CompensableActivity Activity Designer
Compensate Activity Designer
Confirm Activity Designer
TransactionScope Activity Designer

Other Resources

Transaction Activity Designers