TransactionScope Class

.NET Framework (current version)
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

An activity that demarcates a transaction boundary.

Namespace:   System.Activities.Statements
Assembly:  System.Activities (in System.Activities.dll)

System::Object
  System.Activities::Activity
    System.Activities::NativeActivity
      System.Activities.Statements::TransactionScope

[ContentPropertyAttribute("Body")]
public ref class TransactionScope sealed : NativeActivity

NameDescription
System_CAPS_pubmethodTransactionScope()

Initializes a new instance of the TransactionScope class.

NameDescription
System_CAPS_pubpropertyAbortInstanceOnTransactionFailure

Gets or sets the value that indicates whether the workflow should be aborted if the transaction aborts.

System_CAPS_pubpropertyBody

Gets or sets the activity that is scheduled when the TransactionScope executes.

System_CAPS_protpropertyCacheId

Gets the identifier of the cache that is unique within the scope of the workflow definition.(Inherited from Activity.)

System_CAPS_pubpropertyDisplayName

Gets or sets an optional friendly name that is used for debugging, validation, exception handling, and tracking.(Inherited from Activity.)

System_CAPS_pubpropertyId

Gets an identifier that is unique in the scope of the workflow definition.(Inherited from Activity.)

System_CAPS_protpropertyImplementationVersion

Gets or sets the implementation version of the activity.(Inherited from NativeActivity.)

System_CAPS_pubpropertyIsolationLevel

Gets or sets the IsolationLevel for this TransactionScope.

System_CAPS_pubpropertyTimeout

Gets or sets the TimeSpan that indicates the timeout period for the transaction used for this TransactionScope.

NameDescription
System_CAPS_pubmethodEquals(Object^)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodShouldSerializeDisplayName()

Indicates whether the DisplayName property should be serialized.(Inherited from Activity.)

System_CAPS_pubmethodShouldSerializeIsolationLevel()

Indicates whether the IsolationLevel for this TransactionScope should be serialized.

System_CAPS_pubmethodShouldSerializeTimeout()

Indicates whether the Timeout for this TransactionScope should be serialized.

System_CAPS_pubmethodToString()

Returns a String that contains the Id and DisplayName of the Activity.(Inherited from Activity.)

When this activity begins executing, a new Transaction is started if one does not already exist. The transaction commits when the activity and all other participants in the transaction have completed successfully.

System_CAPS_noteNote

The Finally activity member of a TryCatch activity that is the child of a TransactionScope will not execute if an unhandled exception propagates past the TransactionScope boundary.

The following code sample demonstrates creating a TransactionScope activity. This example is from the Basic TransactionScope sample.

new TransactionScope
{
    Body = new Sequence
    {
        Activities = 
        {
            new WriteLine { Text = "    Begin TransactionScope" },

            new PrintTransactionId(),

            new TransactionScopeTest(),

            new WriteLine { Text = "    End TransactionScope" },
        },
    },
},

.NET Framework
Available since 4.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: