DependentTransaction Clase

Definición

Espacio de nombres:

System.Transactions

Ensamblado:

System.Transactions.Local.dll

Source:

DependentTransaction.cs

Describe un clon de una transacción y garantiza que no se puede confirmar la transacción hasta que la aplicación no deja de procesar la transacción. Esta clase no puede heredarse.

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

Herencia

Object

Transaction

DependentTransaction

Ejemplos

En el ejemplo siguiente se muestra cómo crear una transacción dependiente.

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

Comentarios

DependentTransaction es un clon de un Transaction objeto creado mediante el DependentClone método . Su único propósito es permitir que la aplicación se encuentre en reposo y garantizar que la transacción no se puede confirmar mientras el trabajo todavía se realiza en la transacción (por ejemplo, en un subproceso de trabajo).

Cuando el trabajo realizado en la transacción clonada finaliza y está listo para confirmarse, puede informar al creador de la transacción mediante el Complete método . Por lo tanto, puede conservar la coherencia y la corrección de los datos.

La DependentCloneOption enumeración se usa para determinar el comportamiento en la confirmación. Este control de comportamiento permite a una aplicación descansar, así como proporcionar compatibilidad con la simultaneidad. Para obtener más información sobre cómo se usa esta enumeración, consulte Administración de simultaneidad con DependentTransaction.

Propiedades

IsolationLevel	Obtiene el nivel de aislamiento de la transacción. (Heredado de Transaction)
PromoterType	Identifica de forma única el formato del byte[] que devuelve el método Promote cuando se promueve la transacción. (Heredado de Transaction)
TransactionInformation	Recupera información adicional sobre una transacción. (Heredado de Transaction)

Métodos

Clone()	Crea un duplicado de la transacción. (Heredado de Transaction)
Complete()	Intenta finalizar la transacción dependiente.
DependentClone(DependentCloneOption)	Crea un clon dependiente de la transacción. (Heredado de Transaction)
Dispose()	Libera los recursos que mantiene el objeto. (Heredado de Transaction)
EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)	Inscribe un administrador de recursos duradero que admite la confirmación en dos fases para participar en una transacción. (Heredado de Transaction)
EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)	Inscribe un administrador de recursos duradero que admite la optimización de confirmación en dos fases para participar en una transacción. (Heredado de Transaction)
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)	Inscribe a un administrador de recursos que tiene una transacción interna mediante una Inscripción de fase única promocionable (PSPE). (Heredado de Transaction)
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)	Inscribe a un administrador de recursos que tiene una transacción interna mediante una Inscripción de fase única promocionable (PSPE). (Heredado de Transaction)
EnlistVolatile(IEnlistmentNotification, EnlistmentOptions)	Inscribe un administrador de recursos volátil que admite confirmación en dos fases para participar en una transacción. (Heredado de Transaction)
EnlistVolatile(ISinglePhaseNotification, EnlistmentOptions)	Inscribe un administrador de recursos volátil que admite la optimización de confirmación en una fase para participar en una transacción. (Heredado de Transaction)
Equals(Object)	Determina si esta transacción y el objeto especificado son iguales. (Heredado de Transaction)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Transaction)
GetPromotedToken()	Obtiene el devuelto byte[] por el Promote método cuando se promueve la transacción. (Heredado de Transaction)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
PromoteAndEnlistDurable(Guid, IPromotableSinglePhaseNotification, ISinglePhaseNotification, EnlistmentOptions)	Promueve e inscribe un administrador de recursos duradero que admite la confirmación en dos fases para participar en una transacción. (Heredado de Transaction)
Rollback()	Revierte (anula) la transacción. (Heredado de Transaction)
Rollback(Exception)	Revierte (anula) la transacción. (Heredado de Transaction)
SetDistributedTransactionIdentifier(IPromotableSinglePhaseNotification, Guid)	Establece el identificador de transacción distribuida generado por el promotor que no es de MSDTC. (Heredado de Transaction)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

TransactionCompleted

Indica que se ha finalizado la transacción. (Heredado de Transaction)

Implementaciones de interfaz explícitas

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Obtiene una clase SerializationInfo con los datos necesarios para serializar esta transacción. (Heredado de Transaction)

Seguridad para subprocesos

Este tipo es seguro para la ejecución de subprocesos.

Consulte también

• Administrar la simultaneidad con DependentTransaction