<%@ Page Language="C#" MasterPageFile="~/howto/howto.master" %> <%@ Register TagPrefix=Acme Namespace=Acme %> <%@ Register TagPrefix="Acme" TagName="SourceRef" Src="~/util/SrcRef.ascx"%>

How Do I...Use System.Transactions with EnterpriseServices Transactions?

System.Transactions provides functionality that allows interoperability with EnterpriseServices transactions. This sample will show how to use BYOT (Bring Your Own Transactions) with System.Transactions.

What is BYOT?

BYOT allows a component to be created with, or to inherit, an external transaction. That is, a component that does not already have an associated transaction can acquire a transaction. This is done by setting an arbitrary pre-existing transaction as the transaction property of a new component's context. In this case this is the transactions started with System.Transactions.

Convert the transaction:
Because it is necessary to use the BYOT functionality provided by the System.EnterpriseServices namespace, you must first convert the current transaction to be of the System.EnterpriseServices.Itransaction type. This can be done by the static TransactionInterop.GetDtcTransaction method as follows.

System.EnterpriseServices.ITransaction estx = null; estx = (System.EnterpriseServices.ITransaction) TransactionInterop.GetDtcTransaction(Transaction.Current); Dim estx As System.EnterpriseServices.ITransaction estx = CType(TransactionInterop.GetDtcTransaction(Transaction.Current), System.EnterpriseServices.ITransaction)

Associate a component with the transaction:
You can use the CreateWithTransaction method of the System.EnterpriseServices.BYOT class to do the actual work. In this case, an object, SvcComp, inheriting from System.EnterpriseServices.ServicedComponent will receive a reference to the requested transaction.

SvcComp sc = (SvcComp) BYOT.CreateWithTransaction(estx, typeof(SvcComp)); Dim sc As SvcComp = New SvcComp System.EnterpriseServices.BYOT.CreateWithTransaction(estx, sc.GetType)

Obtain context information for the component:
Next, the System.EnterpriseServices.ContextUtil class is used to obtain information about the context of the object that inherits this transaction. Specifically, the sample must determine the GUID of the current transaction, and whether the current context is transactional. The following properties are used to obtain this information.

Console.WriteLine("IsInTransaction {0}", ContextUtil.IsInTransaction); Console.WriteLine("TransactionId {0}", ContextUtil.TransactionId); Console.WriteLine("IsInTransaction {0}", ContextUtil.IsInTransaction) Console.WriteLine("TransactionId {0}", ContextUtil.TransactionId)

Here is a full example: