Mise à jour : novembre 2007
Termine la portée de transaction.
(dans System.Transactions.dll)
Visual Basic (Déclaration)
Visual Basic (Utilisation)
Dim instance As TransactionScope
instance.Dispose()
public:
virtual void Dispose() sealed
public final void Dispose()
public final function Dispose()
Implémentations
IDisposable..::.Dispose()()()
L'appel à cette méthode marque la fin de la portée de transaction. Si l'objet TransactionScope a créé la transaction et que Complete a été appelé sur la portée, l'objet TransactionScope essaie de valider la transaction lorsque cette méthode est appelée.
L'utilisation de la construction using C# garantit que cette méthode est appelée même si une exception se produit. Les exceptions qui se produisent après avoir appelé cette méthode peuvent ne pas affecter la transaction. Cette méthode restaure également la transaction ambiante à son état d'origine. Un TransactionAbortedException est levé si la transaction n'est pas réellement validée.
Cette méthode est synchrone et bloque tant que la transaction n'a pas été validée ou abandonnée. De ce fait, soyez extrêmement prudent lorsque vous utilisez cette méthode dans une application Windows Form (WinForm), car un blocage peut se produire. Si vous appelez cette méthode dans un événement de contrôle Windows Form (par exemple, en cliquant sur un bouton) et que vous utilisez la méthode Invoke synchrone pour indiquer au contrôle d'effectuer des tâches d'interface utilisateur (par exemple, modifier des couleurs) au cours du traitement de la transaction, un blocage se produira. Ceci est dû au fait que la méthode Invoke est synchrone et qu'elle bloque le thread de travail jusqu'à ce que le thread d'interface utilisateur termine son travail. Toutefois, dans notre scénario, le thread d'interface utilisateur attend également que le thread de travail valide la transaction. Au final, ni l'un ni l'autre n'est capable de continuer et la portée attend indéfiniment la fin de la validation. Dans la mesure du possible, il est recommandé d'utiliser BeginInvoke plutôt que Invoke, car il est asynchrone et donc moins enclin à se bloquer.
Pour plus d'informations sur la manière d'utiliser cette méthode, consultez la rubrique Implémentation d'une transaction implicite à l'aide de l'étendue de transaction.
L'exemple suivant montre comment utiliser la classe TransactionScope pour définir un bloc de code en vue de participer à une transaction.
' 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)
Catch ex As ApplicationException
writer.WriteLine("ApplicationException Message: {0}", ex.Message)
End Try
' Display messages.
Console.WriteLine(writer.ToString())
Return returnValue
End Function
' 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)
Catch ex As ApplicationException
writer.WriteLine("ApplicationException Message: {0}", ex.Message)
End Try
' Display messages.
Console.WriteLine(writer.ToString())
Return returnValue
End Function
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
.NET Framework
Pris en charge dans : 3.5, 3.0, 2.0
Référence
Autres ressources