TransactionScope Activity Designer

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

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

The TransactionScope Activity

The TransactionScope activity executes the contained activity in a single transaction. The transaction commits when the Body activity and all other participants in the transaction have completed successfully.

Using the TransactionScope Activity Designer

Access the TransactionScope activity designer in the Transaction category of the Toolbox. The TransactionScope 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 TransactionScope activity with a default DisplayName of TransactionScope. The DisplayName value can be edited in the header of the TransactionScope activity designer or in the DisplayName box of the property grid.

The TransactionScope Properties

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

Property Name Required Usage
DisplayName False The optional friendly name of the TransactionScope activity. The default is TransactionScope. Although the DisplayName value is not strictly required, it is a best practice to use one.
Body True Specifies the activity to execute in a single transaction. To add the Body activity, drop an activity from the Toolbox into the Body box on the TransactionScope activity designer with hint text "Drop activity here".
IsolationLevel True Specifies the IsolationLevel for this TransactionScope.
Timeout False Specifies the interval of time (formatted as 00:00:00, which indicates hours:minutes:seconds) that the transaction has to complete. The default value is 1 minute (00:01:00).
AbortInstanceOnTransactionFailure True Specifies the value that indicates whether the workflow should be aborted if the transaction aborts.

See also