DependentTransaction 類別

定義

命名空間:

System.Transactions

組件:

System.Transactions.Local.dll

Source:

DependentTransaction.cs

描述交易的複製品 (Clone)，其可保證在交易上執行工作時，必須等到應用程式停止後才能認可交易。 此類別無法獲得繼承。

public ref class DependentTransaction sealed : System::Transactions::Transaction

public sealed class DependentTransaction : System.Transactions.Transaction

type DependentTransaction = class
    inherit Transaction

Public NotInheritable Class DependentTransaction
Inherits Transaction

繼承

Object

Transaction

DependentTransaction

範例

下列範例示範如何建立相依交易。

static void Main(string[] args)
{
    try
    {
        using (TransactionScope scope = new TransactionScope())
        {
            // Perform transactional work here.

            //Queue work item
            ThreadPool.QueueUserWorkItem(new WaitCallback(WorkerThread), Transaction.Current.DependentClone(DependentCloneOption.BlockCommitUntilComplete));

            //Display transaction information
            Console.WriteLine("Transaction information:");
            Console.WriteLine("ID:             {0}", Transaction.Current.TransactionInformation.LocalIdentifier);
            Console.WriteLine("status:         {0}", Transaction.Current.TransactionInformation.Status);
            Console.WriteLine("isolationlevel: {0}", Transaction.Current.IsolationLevel);

            //Call Complete on the TransactionScope based on console input
            ConsoleKeyInfo c;
            while (true)
            {
                            Console.Write("Complete the transaction scope? [Y|N] ");
                c = Console.ReadKey();
                Console.WriteLine();

                if ((c.KeyChar == 'Y') || (c.KeyChar == 'y'))
                {
                    //Call complete on the scope
                    scope.Complete();
                    break;
                }
                else if ((c.KeyChar == 'N') || (c.KeyChar == 'n'))
                {
                    break;
                }
            }
        }
    }
    catch (System.Transactions.TransactionException ex)
    {
        Console.WriteLine(ex);
    }
    catch
    {
        Console.WriteLine("Cannot complete transaction");
        throw;
    }
}

private static void WorkerThread(object transaction)
{
    //Create a DependentTransaction from the object passed to the WorkerThread
    DependentTransaction dTx = (DependentTransaction)transaction;

    //Sleep for 1 second to force the worker thread to delay
    Thread.Sleep(1000);

    //Pass the DependentTransaction to the scope, so that work done in the scope becomes part of the transaction passed to the worker thread
    using (TransactionScope ts = new TransactionScope(dTx))
    {
        //Perform transactional work here.

        //Call complete on the transaction scope
        ts.Complete();
    }

    //Call complete on the dependent transaction
    dTx.Complete();
}

Public Shared Sub Main()
    Try
        Using scope As TransactionScope = New TransactionScope()

            'Perform transactional work here.

            'Queue work item
            ThreadPool.QueueUserWorkItem(AddressOf WorkerThread, Transaction.Current.DependentClone(DependentCloneOption.BlockCommitUntilComplete))

            'Display transaction information
            Console.WriteLine("Transaction information:")
            Console.WriteLine("ID:             {0}", Transaction.Current.TransactionInformation.LocalIdentifier)
            Console.WriteLine("status:         {0}", Transaction.Current.TransactionInformation.Status)
            Console.WriteLine("isolationlevel: {0}", Transaction.Current.IsolationLevel)

            'Call Complete on the TransactionScope based on console input
            Dim c As ConsoleKeyInfo
            While (True)

                Console.Write("Complete the transaction scope? [Y|N] ")
                c = Console.ReadKey()
                Console.WriteLine()
                If (c.KeyChar = "Y") Or (c.KeyChar = "y") Then
                    scope.Complete()
                    Exit While
                ElseIf ((c.KeyChar = "N") Or (c.KeyChar = "n")) Then
                    Exit While
                End If
            End While
        End Using

    Catch ex As TransactionException
        Console.WriteLine(ex)
    Catch
        Console.WriteLine("Cannot complete transaction")
        Throw
    End Try
End Sub

Public Shared Sub WorkerThread(ByVal myTransaction As Object)

    'Create a DependentTransaction from the object passed to the WorkerThread
    Dim dTx As DependentTransaction
    dTx = CType(myTransaction, DependentTransaction)

    'Sleep for 1 second to force the worker thread to delay
    Thread.Sleep(1000)

    'Pass the DependentTransaction to the scope, so that work done in the scope becomes part of the transaction passed to the worker thread
    Using ts As TransactionScope = New TransactionScope(dTx)
        'Perform transactional work here.

        'Call complete on the transaction scope
        ts.Complete()
    End Using

    'Call complete on the dependent transaction
    dTx.Complete()
End Sub

備註

DependentTransaction是使用 DependentClone 方法建立之物件的複製Transaction品。 其唯一目的是讓應用程式進入待用，並保證交易在工作仍在 (交易上執行時無法認可，例如，在背景工作線程上) 。

當複製交易內完成的工作完成且準備好認可時，可以使用 方法通知建立者交易 Complete 。 因此，您可以保留數據的一致性和正確性。

列舉 DependentCloneOption 可用來判斷認可的行為。 此行為控制可讓應用程式待用，並提供並行支援。 如需如何使用這個列舉的詳細資訊，請參閱 使用 DependentTransaction 管理並行存取。

屬性

IsolationLevel	取得交易的隔離等級 (Isolation Level)。 (繼承來源 Transaction)
PromoterType	可唯一識別 byte[] 的格式，其由 Promote 方法在交易升級時傳回。 (繼承來源 Transaction)
TransactionInformation	擷取交易的其他資訊。 (繼承來源 Transaction)

方法

Clone()	建立交易的複製品 (Clone)。 (繼承來源 Transaction)
Complete()	嘗試完成相依交易。
DependentClone(DependentCloneOption)	建立交易的相依複製品。 (繼承來源 Transaction)
Dispose()	釋放該物件所持有的資源。 (繼承來源 Transaction)
EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)	登記支援兩階段交易認可 (Two-Phase Commit) 的長期資源管理員以參與交易。 (繼承來源 Transaction)
EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)	登記支援單一階段交易認可最佳化的長期資源管理員以參與交易。 (繼承來源 Transaction)
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)	使用可提升單一階段登記 (PSPE) 來登記具有內部交易的資源管理員。 (繼承來源 Transaction)
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)	使用可提升單一階段登記 (PSPE) 來登記具有內部交易的資源管理員。 (繼承來源 Transaction)
EnlistVolatile(IEnlistmentNotification, EnlistmentOptions)	登錄暫時性資源管理員，支援兩階段交易認可參與交易。 (繼承來源 Transaction)
EnlistVolatile(ISinglePhaseNotification, EnlistmentOptions)	登記支援單一階段交易認可最佳化的暫時性 (Volatile) 資源管理員以參與交易。 (繼承來源 Transaction)
Equals(Object)	判斷這個交易和指定的物件是否相等。 (繼承來源 Transaction)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Transaction)
GetPromotedToken()	byte[]取得升級交易時，方法所傳Promote回的 。 (繼承來源 Transaction)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
PromoteAndEnlistDurable(Guid, IPromotableSinglePhaseNotification, ISinglePhaseNotification, EnlistmentOptions)	提升和登記支援兩階段交易認可 (Two-Phase Commit) 的長期資源管理員以參與異動。 (繼承來源 Transaction)
Rollback()	復原 (中止) 交易。 (繼承來源 Transaction)
Rollback(Exception)	復原 (中止) 交易。 (繼承來源 Transaction)
SetDistributedTransactionIdentifier(IPromotableSinglePhaseNotification, Guid)	設定非 MSDTC Promoter 所產生的分散式異動識別碼。 (繼承來源 Transaction)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

事件

TransactionCompleted

指出交易已完成。 (繼承來源 Transaction)

明確介面實作

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

取得 SerializationInfo，其中含有序列化這個交易所需的資料。 (繼承來源 Transaction)

執行緒安全性

此型別具備執行緒安全。

另請參閱

• 使用 DependentTransaction 管理並行存取