TransactionScope Clase

Definición

Espacio de nombres:

System.Transactions

Ensamblado:

System.Transactions.Local.dll

Source:

TransactionScope.cs

Crea un bloque de código transaccional. Esta clase no puede heredarse.

public ref class TransactionScope sealed : IDisposable

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public sealed class TransactionScope : IDisposable

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
type TransactionScope = class
    interface IDisposable

Public NotInheritable Class TransactionScope
Implements IDisposable

Herencia

Object

TransactionScope

Atributos

UnsupportedOSPlatformAttribute

Implementaciones

IDisposable

Ejemplos

En el ejemplo siguiente se muestra cómo usar la TransactionScope clase para definir un bloque de código para participar en una transacción.

// This function takes arguments for 2 connection strings and commands to create a transaction 
// involving two SQL Servers. It returns a value > 0 if the transaction is committed, 0 if the 
// transaction is rolled back. To test this code, you can connect to two different databases 
// on the same server by altering the connection string, or to another 3rd party RDBMS by 
// altering the code in the connection2 code block.
static public int CreateTransactionScope(
    string connectString1, string connectString2,
    string commandText1, string commandText2)
{
    // Initialize the return value to zero and create a StringWriter to display results.
    int returnValue = 0;
    System.IO.StringWriter writer = new System.IO.StringWriter();

    try
    {
        // Create the TransactionScope to execute the commands, guaranteeing
        // that both commands can commit or roll back as a single unit of work.
        using (TransactionScope scope = new TransactionScope())
        {
            using (SqlConnection connection1 = new SqlConnection(connectString1))
            {
                // Opening the connection automatically enlists it in the 
                // TransactionScope as a lightweight transaction.
                connection1.Open();

                // Create the SqlCommand object and execute the first command.
                SqlCommand command1 = new SqlCommand(commandText1, connection1);
                returnValue = command1.ExecuteNonQuery();
                writer.WriteLine("Rows to be affected by command1: {0}", returnValue);

                // If you get here, this means that command1 succeeded. By nesting
                // the using block for connection2 inside that of connection1, you
                // conserve server and network resources as connection2 is opened
                // only when there is a chance that the transaction can commit.   
                using (SqlConnection connection2 = new SqlConnection(connectString2))
                {
                    // The transaction is escalated to a full distributed
                    // transaction when connection2 is opened.
                    connection2.Open();

                    // Execute the second command in the second database.
                    returnValue = 0;
                    SqlCommand command2 = new SqlCommand(commandText2, connection2);
                    returnValue = command2.ExecuteNonQuery();
                    writer.WriteLine("Rows to be affected by command2: {0}", returnValue);
                }
            }

            // The Complete method commits the transaction. If an exception has been thrown,
            // Complete is not  called and the transaction is rolled back.
            scope.Complete();
        }
    }
    catch (TransactionAbortedException ex)
    {
        writer.WriteLine("TransactionAbortedException Message: {0}", ex.Message);
    }

    // Display messages.
    Console.WriteLine(writer.ToString());

    return returnValue;
}

'  This function takes arguments for 2 connection strings and commands to create a transaction 
'  involving two SQL Servers. It returns a value > 0 if the transaction is committed, 0 if the 
'  transaction is rolled back. To test this code, you can connect to two different databases 
'  on the same server by altering the connection string, or to another 3rd party RDBMS  
'  by altering the code in the connection2 code block.
Public Function CreateTransactionScope( _
  ByVal connectString1 As String, ByVal connectString2 As String, _
  ByVal commandText1 As String, ByVal commandText2 As String) As Integer

    ' Initialize the return value to zero and create a StringWriter to display results.
    Dim returnValue As Integer = 0
    Dim writer As System.IO.StringWriter = New System.IO.StringWriter

    Try
    ' Create the TransactionScope to execute the commands, guaranteeing
    '  that both commands can commit or roll back as a single unit of work.
        Using scope As New TransactionScope()
            Using connection1 As New SqlConnection(connectString1)
                ' Opening the connection automatically enlists it in the 
                ' TransactionScope as a lightweight transaction.
                connection1.Open()

                ' Create the SqlCommand object and execute the first command.
                Dim command1 As SqlCommand = New SqlCommand(commandText1, connection1)
                returnValue = command1.ExecuteNonQuery()
                writer.WriteLine("Rows to be affected by command1: {0}", returnValue)

                ' If you get here, this means that command1 succeeded. By nesting
                ' the using block for connection2 inside that of connection1, you
                ' conserve server and network resources as connection2 is opened
                ' only when there is a chance that the transaction can commit.   
                Using connection2 As New SqlConnection(connectString2)
                    ' The transaction is escalated to a full distributed
                    ' transaction when connection2 is opened.
                    connection2.Open()

                    ' Execute the second command in the second database.
                    returnValue = 0
                    Dim command2 As SqlCommand = New SqlCommand(commandText2, connection2)
                    returnValue = command2.ExecuteNonQuery()
                    writer.WriteLine("Rows to be affected by command2: {0}", returnValue)
                End Using
            End Using

        ' The Complete method commits the transaction. If an exception has been thrown,
        ' Complete is called and the transaction is rolled back.
        scope.Complete()
        End Using
    Catch ex As TransactionAbortedException
        writer.WriteLine("TransactionAbortedException Message: {0}", ex.Message)
    End Try

    ' Display messages.
    Console.WriteLine(writer.ToString())

    Return returnValue
End Function

Comentarios

La System.Transactions infraestructura proporciona un modelo de programación explícito basado en la Transaction clase , así como un modelo de programación implícito mediante la clase , en la TransactionScope que la infraestructura administra automáticamente las transacciones.

Importante

Se recomienda crear transacciones implícitas mediante la TransactionScope clase para que el contexto de transacción ambiente se administre automáticamente. También debe usar la TransactionScope clase y DependentTransaction para las aplicaciones que requieren el uso de la misma transacción en varias llamadas de función o varias llamadas a subprocesos. Para obtener más información sobre este modelo, vea el tema Implementación de una transacción implícita mediante ámbito de transacción . Para obtener más información sobre cómo escribir una aplicación transaccional, consulte Escritura de una aplicación transaccional.

Al crear una instancia de mediante TransactionScope la new instrucción , el administrador de transacciones determina en qué transacción participar. Una vez determinado, el ámbito siempre participa en esa transacción. La decisión se basa en dos factores: si está presente una transacción de ambiente y el valor del parámetro TransactionScopeOption del constructor. La transacción ambiente es la transacción en la que se ejecuta el código. Puede obtener una referencia a la transacción ambiente llamando a la propiedad estática Transaction.Current de la clase Transaction. Para obtener más información sobre cómo se usa este parámetro, vea la sección "Administración de flujos de transacciones" del tema Implementación de una transacción implícita mediante ámbito de transacción.

Si no se produce ninguna excepción dentro del ámbito de la transacción (es decir, entre la inicialización del TransactionScope objeto y la llamada de su Dispose método), la transacción en la que participa el ámbito puede continuar. Si se produce una excepción dentro del ámbito de la transacción, se revertirá la transacción en la que participa.

Cuando la aplicación complete todo el trabajo que desea realizar en una transacción, debe llamar al Complete método solo una vez para informar al administrador de transacciones de que es aceptable confirmar la transacción. Si no se llama a este método, se anula la transacción.

Una llamada al Dispose método marca el final del ámbito de la transacción. Las excepciones que se producen después de llamar a este método quizá no afecten a la transacción.

Si modifica el valor de dentro de Current un ámbito, se produce una excepción cuando Dispose se llama a . Sin embargo, al final del ámbito, se restaura el valor anterior. Además, si llama a DisposeCurrent dentro de un ámbito de transacción que creó la transacción, la transacción se anula al final del ámbito.

Constructores

TransactionScope()	Inicializa una nueva instancia de la clase TransactionScope.
TransactionScope(Transaction)	Inicializa una nueva instancia de la clase TransactionScope y establece la transacción especificada como la transacción de ambiente, de manera que el trabajo transaccional realizado dentro del ámbito utiliza esta transacción.
TransactionScope(Transaction, TimeSpan)	Inicializa una nueva instancia de la clase TransactionScope con el valor de tiempo de espera especificado y establece la transacción especificada como la transacción de ambiente, de manera que el trabajo transaccional realizado dentro del ámbito utiliza esta transacción.
TransactionScope(Transaction, TimeSpan, EnterpriseServicesInteropOption)	Inicializa una nueva instancia de la clase TransactionScope con el valor de tiempo de espera especificado y los requisitos de interoperabilidad de COM+ y establece la transacción especificada como la transacción de ambiente, de modo que el trabajo transaccional realizado dentro del ámbito utiliza esta transacción.
TransactionScope(Transaction, TimeSpan, TransactionScopeAsyncFlowOption)	[Compatible con .NET Framework 4.5.1 y versiones posteriores] Inicializa una nueva instancia de la clase TransactionScope con el valor de tiempo de espera especificado y establece la transacción especificada como la transacción de ambiente, de manera que el trabajo transaccional realizado dentro del ámbito utiliza esta transacción.
TransactionScope(Transaction, TransactionScopeAsyncFlowOption)	[Compatible con .NET Framework 4.5.1 y versiones posteriores] Inicializa una nueva instancia de la clase TransactionScope y establece la transacción especificada como la transacción de ambiente, de manera que el trabajo transaccional realizado dentro del ámbito utiliza esta transacción.
TransactionScope(TransactionScopeAsyncFlowOption)	Inicializa una nueva instancia de la clase TransactionScope con la opción de flujo asincrónica especificada.
TransactionScope(TransactionScopeOption)	Inicializa una nueva instancia de la clase TransactionScope con los requisitos especificados.
TransactionScope(TransactionScopeOption, TimeSpan)	Inicializa una nueva instancia de la clase TransactionScope con el valor de tiempo de espera y los requisitos especificados.
TransactionScope(TransactionScopeOption, TimeSpan, TransactionScopeAsyncFlowOption)	Inicializa una nueva instancia de la clase TransactionScope con el valor de tiempo de espera, los requisitos y la opción de flujo asíncrona especificados.
TransactionScope(TransactionScopeOption, TransactionOptions)	Inicializa una nueva instancia de la clase TransactionScope con los requisitos especificados.
TransactionScope(TransactionScopeOption, TransactionOptions, EnterpriseServicesInteropOption)	Inicializa una nueva instancia de la clase TransactionScope con el ámbito y los requisitos de interoperabilidad de COM+ especificados y opciones de transacción.
TransactionScope(TransactionScopeOption, TransactionOptions, TransactionScopeAsyncFlowOption)	[Compatible con .NET Framework 4.5.1 y versiones posteriores] Inicializa una nueva instancia de la clase TransactionScope con los requisitos y la opción de flujo asíncrona especificados.
TransactionScope(TransactionScopeOption, TransactionScopeAsyncFlowOption)	Inicializa una nueva instancia de la clase TransactionScope con los requisitos y la opción de flujo asíncrona especificados.

Métodos

Complete()	Indica que finalizan correctamente todas las operaciones dentro del ámbito.
Dispose()	Finaliza el ámbito de la transacción.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Seguridad para subprocesos

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

Consulte también

• Implementación de una transacción implícita mediante el ámbito de transacción