DependentTransaction Класс

Определение

Пространство имен:

System.Transactions

Сборка:

System.Transactions.Local.dll

Исходный код:

DependentTransaction.cs

Описывает клон транзакции, гарантирующий невозможность фиксации транзакции до тех пор, пока приложение не дойдет до выполнения последних действий, связанных с операциями по транзакции. Этот класс не наследуется.

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 это клон объекта, созданного Transaction с помощью DependentClone метода . Его единственная цель — позволить приложению не работать и гарантировать, что транзакция не сможет зафиксироваться во время выполнения работы над транзакцией (например, в рабочем потоке).

Когда работа, выполненная в клонируемой транзакции, будет завершена и готова к фиксации, она может сообщить создателю транзакции с помощью Complete метода . Таким образом, можно сохранить согласованность и правильность данных.

Перечисление DependentCloneOption используется для определения поведения при фиксации. Этот элемент управления поведением позволяет приложению неактивно работать, а также обеспечивает поддержку параллелизма. Дополнительные сведения об использовании этого перечисления см. в разделе Управление параллелизмом с помощью DependentTransaction.

Свойства

IsolationLevel	Получает уровень изоляции транзакции. (Унаследовано от Transaction)
PromoterType	Однозначно определяет формат byte[] , возвращенного методом Promote при повышении уровня транзакции. (Унаследовано от Transaction)
TransactionInformation	Извлекает дополнительные сведения о транзакции. (Унаследовано от Transaction)

Методы

Clone()	Создает копию транзакции. (Унаследовано от Transaction)
Complete()	Пытается завершить зависимую транзакцию.
DependentClone(DependentCloneOption)	Создает зависимую копию транзакции. (Унаследовано от Transaction)
Dispose()	Освобождает ресурсы, удерживаемые объектом. (Унаследовано от Transaction)
EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)	Присоединяет диспетчер долгосрочных ресурсов, поддерживающий двухфазную фиксацию, для участия в транзакции. (Унаследовано от Transaction)
EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)	Присоединяет диспетчер долгосрочных ресурсов, поддерживающий однофазную оптимизацию фиксации, для участия в транзакции. (Унаследовано от Transaction)
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)	Присоединяет диспетчер ресурсов, имеющий внутреннюю транзакцию, с помощью повышаемого однофазного зачисления (PSPE). (Унаследовано от Transaction)
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)	Присоединяет диспетчер ресурсов, имеющий внутреннюю транзакцию, с помощью повышаемого однофазного зачисления (PSPE). (Унаследовано от Transaction)
EnlistVolatile(IEnlistmentNotification, EnlistmentOptions)	Включает диспетчер быстро изменяющихся ресурсов с поддержкой двухфазной фиксации для участия в транзакции. (Унаследовано от Transaction)
EnlistVolatile(ISinglePhaseNotification, EnlistmentOptions)	Присоединяет диспетчер переменных ресурсов, поддерживающий однофазную оптимизацию фиксации, для участия в транзакции. (Унаследовано от Transaction)
Equals(Object)	Определяет, равны ли данная транзакция и указанный объект. (Унаследовано от Transaction)
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от Transaction)
GetPromotedToken()	Возвращает объект , byte[] возвращаемый методом Promote при повышении уровня транзакции. (Унаследовано от Transaction)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
PromoteAndEnlistDurable(Guid, IPromotableSinglePhaseNotification, ISinglePhaseNotification, EnlistmentOptions)	Продвигает и присоединяет диспетчер долгосрочных ресурсов, поддерживающий двухфазную фиксацию, для участия в транзакции. (Унаследовано от Transaction)
Rollback()	Выполняет откат транзакции (прерывает ее). (Унаследовано от Transaction)
Rollback(Exception)	Выполняет откат транзакции (прерывает ее). (Унаследовано от Transaction)
SetDistributedTransactionIdentifier(IPromotableSinglePhaseNotification, Guid)	Задает идентификатор распределенной транзакции, созданный отличным от MSDTC активатором. (Унаследовано от Transaction)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

TransactionCompleted

Указывает, что транзакция завершена. (Унаследовано от Transaction)

Явные реализации интерфейса

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Получает SerializationInfo вместе с данными, необходимыми для сериализации данной транзакции. (Унаследовано от Transaction)

Потокобезопасность

Данный тип потокобезопасен.

См. также раздел

• Управление параллелизмом с помощью класса DependentTransaction