Exportar (0) Imprimir
Expandir todo

TransactionScope (Clase)

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

Espacio de nombres: System.Transactions
Ensamblado: System.Transactions (en system.transactions.dll)

public sealed class TransactionScope : IDisposable
public final class TransactionScope implements IDisposable
public final class TransactionScope implements IDisposable
No aplicable.

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

NotaImportante:

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

Al crear una instancia de TransactionScope mediante la instrucción new, el administrador de transacciones determina en qué transacción va a participar. Una vez determinada, 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 de ambiente es aquélla en la que se ejecuta el código. Puede obtener una referencia a la transacción de ambiente llamando a la propiedad Current estática de la clase Transaction. Para obtener más información sobre la utilización de este parámetro, consulte la sección sobre administración del flujo de transacciones del tema Implementar una transacción implícita con el á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 objeto TransactionScope y la llamada de su método Dispose), entonces se permite que la transacción en la que participa el ámbito continúe. Si aparece una excepción dentro del ámbito de la transacción, se deshará la transacción en la que participa.

Cuando la aplicación termina todo el trabajo que tiene que llevar a cabo en una transacción, debe llamar al método Complete sólo una vez para notificar al administrador de transacciones que la transacción se puede confirmar. Si no se puede llamar a este método se anula la transacción.

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

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

En el ejemplo siguiente se muestra cómo utilizar la clase TransactionScope 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();

    // 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))
        {
            try
            {
                // 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))
                    try
                    {
                        // 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);
                    }
                    catch (Exception ex)
                    {
                        // Display information that command2 failed.
                        writer.WriteLine("returnValue for command2: {0}", returnValue);
                        writer.WriteLine("Exception Message2: {0}", ex.Message);
                    }
            }
            catch (Exception ex)
            {
                // Display information that command1 failed.
                writer.WriteLine("returnValue for command1: {0}", returnValue);
                writer.WriteLine("Exception Message1: {0}", ex.Message);
            }
        }

        // The Complete method commits the transaction. If an exception has been thrown,
        // Complete is not  called and the transaction is rolled back.
        scope.Complete();
    }

    // The returnValue is greater than 0 if the transaction committed.
    if (returnValue > 0)
    {
        writer.WriteLine("Transaction was committed.");
    }
    else
    {
        // You could write additional business logic here, for example, you can notify the caller 
        // by throwing a TransactionAbortedException, or logging the failure.
        writer.WriteLine("Transaction rolled back.");
    }

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

    return returnValue;
}

System.Object
  System.Transactions.TransactionScope

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

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar:
© 2015 Microsoft