System.Transactions Namespace

Contains classes that allow you to write your own transactional application and resource manager. Specifically, you can create and participate in a transaction (local or distributed) with one or multiple participants.

Classes

CommittableTransaction	Describes a committable transaction.
DependentTransaction	Describes a clone of a transaction providing guarantee that the transaction cannot be committed until the application comes to rest regarding work on the transaction. This class cannot be inherited.
Enlistment	Facilitates communication between an enlisted transaction participant and the transaction manager during the final phase of the transaction.
PreparingEnlistment	Facilitates communication between an enlisted transaction participant and the transaction manager during the Prepare phase of the transaction.
SinglePhaseEnlistment	Provides a set of callbacks that facilitate communication between a participant enlisted for Single Phase Commit and the transaction manager when the SinglePhaseCommit(SinglePhaseEnlistment) notification is received.
SubordinateTransaction	Represents a non-rooted transaction that can be delegated. This class cannot be inherited.
Transaction	Represents a transaction.
TransactionAbortedException	The exception that is thrown when an operation is attempted on a transaction that has already been rolled back, or an attempt is made to commit the transaction and the transaction aborts.
TransactionEventArgs	Provides data for the following transaction events: DistributedTransactionStarted, TransactionCompleted.
TransactionException	The exception that is thrown when you attempt to do work on a transaction that cannot accept new work.
TransactionInDoubtException	The exception that is thrown when an operation is attempted on a transaction that is in doubt, or an attempt is made to commit the transaction and the transaction becomes InDoubt.
TransactionInformation	Provides additional information regarding a transaction.
TransactionInterop	Facilitates interaction between System.Transactions and components that were previously written to interact with MSDTC, COM+, or System.EnterpriseServices. This class cannot be inherited.
TransactionManager	Contains methods used for transaction management. This class cannot be inherited.
TransactionManagerCommunicationException	The exception that is thrown when a resource manager cannot communicate with the transaction manager.
TransactionPromotionException	The exception that is thrown when a promotion fails.
TransactionScope	Makes a code block transactional. This class cannot be inherited.

Structs

TransactionOptions

Contains additional information that specifies transaction behaviors.

Interfaces

IDtcTransaction	Describes a DTC transaction.
IEnlistmentNotification	Describes an interface that a resource manager should implement to provide two phase commit notification callbacks for the transaction manager upon enlisting for participation.
IPromotableSinglePhaseNotification	Describes an object that acts as a commit delegate for a non-distributed transaction internal to a resource manager.
ISimpleTransactionSuperior	Represents a transaction that is not a root transaction, but can be escalated to be managed by the MSDTC.
ISinglePhaseNotification	Describes a resource object that supports single phase commit optimization to participate in a transaction.
ITransactionPromoter	Describes a delegated transaction for an existing transaction that can be escalated to be managed by the MSDTC when needed.

Enums

DependentCloneOption	Controls what kind of dependent transaction to create.
EnlistmentOptions	Determines whether the object should be enlisted during the prepare phase.
EnterpriseServicesInteropOption	Specifies how distributed transactions interact with COM+ transactions.
IsolationLevel	Specifies the isolation level of a transaction.
TransactionScopeAsyncFlowOption	Specifies whether transaction flow across thread continuations is enabled for TransactionScope.
TransactionScopeOption	Provides additional options for creating a transaction scope.
TransactionStatus	Describes the current status of a distributed transaction.

Delegates

HostCurrentTransactionCallback	Provides a mechanism for the hosting environment to supply its own default notion of Current.
TransactionCompletedEventHandler	Represents the method that handles the TransactionCompleted event of a Transaction class.
TransactionStartedEventHandler	Represents the method that will handle the DistributedTransactionStarted event of a TransactionManager class.

Remarks

The System.Transactions infrastructure makes transactional programming simple and efficient throughout the platform by supporting transactions initiated in SQL Server, ADO.NET, MSMQ, and the Microsoft Distributed Transaction Coordinator (MSDTC). It provides both an explicit programming model based on the Transaction class, as well as an implicit programming model using the TransactionScope class, in which transactions are automatically managed by the infrastructure. It is highly recommended that you use the easier implicit model for development. To get started, see the Implementing An Implicit Transaction Using Transaction Scope topic. For more information on writing a transactional application, see Writing A Transactional Application.

System.Transactions also provides types for you to implement a resource manager. The transaction manager native to the System.Transactions infrastructure allows volatile resources or a single durable resource enlistment to commit or roll back efficiently. For more information on implementing a resource manager, see Implementing A Resource Manager.

The transaction manager also transparently escalates local transactions to distributed transactions by coordinating through a disk-based transaction manager like the DTC, when an additional durable resource manager enlists itself with a transaction. There are two key ways that the System.Transactions infrastructure provides enhanced performance.

• Dynamic Escalation, which means that the System.Transactions infrastructure only engages the MSDTC when it is actually required for a transaction. This area is covered in depth in the Transaction Management Escalation topic.

• Promotable Enlistments, which allows a resource, such as a database, to take ownership of the transaction if it is the only entity participating in the transaction. Later, if needed, the System.Transactions infrastructure can still escalate the management of the transaction to MSDTC. This further reduces the chance of using the MSDTC. This area is covered in depth in the Optimization Using Single Phase Commit and Promotable Single Phase Notification topic.

For more information on how to use the System.Transactions namespace, see Transaction Processing.