TransactionScope.Dispose (Método)
Ensamblado: System.Transactions (en system.transactions.dll)
Al llamar a este método, se marca el fin del ámbito de la transacción. Si el objeto TransactionScope ha creado la transacción y se ha llamado al método Complete en el ámbito, el objeto TransactionScope intenta confirmar la transacción cuando se llama a este método.
El uso de la construcción using de C# garantiza que se llama a este método aún cuando se produzca una excepción. Las excepciones que se producen después de llamar a este método quizá no afecten a la transacción. Este método también restaura la transacción de ambiente a su estado original. Se produce una excepción TransactionAbortedException si no se confirma la transacción realmente.
Este método es sincrónico y se bloquea hasta que la transacción se ha confirmado o anulado. Por ello, debe ser sumamente cuidadoso al utilizar este método en una aplicación de Windows Forms (WinForm), ya que podría producirse un interbloqueo. Si llama a este método en un evento de control de WinForm (por ejemplo, un clic en un botón) y utiliza el método sincrónico Invoke para indicar al control que realice tareas de la interfaz de usuario (como cambiar los colores) cuando se está procesando la transacción, se producirá un interbloqueo. Esto se debe a que el método Invoke es sincrónico y bloquea el subproceso de trabajo hasta que el subproceso de interfaz de usuario finaliza su trabajo. Sin embargo, en nuestro caso, el subproceso de interfaz de usuario espera también a que el subproceso de trabajo confirme la transacción. El resultado es que ninguno de los dos puede continuar y el ámbito espera indefinidamente a que finalice la confirmación. Debe utilizar el método BeginInvoke en lugar de Invoke siempre que sea posible, porque es asincrónico y es menos probable que cree interbloqueos.
Para obtener más información sobre la forma de utilizar este método, vea el tema Implementar una transacción implícita con el ámbito de transacción.
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; }
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.