CommittableTransaction.Commit Méthode

Définition

Essaie de valider la transaction.Attempts to commit the transaction.

public:
 void Commit();
public void Commit ();
member this.Commit : unit -> unit
Public Sub Commit ()

Exceptions

Commit() est appelé sur une transaction et la transaction devient InDoubt.Commit() is called on a transaction and the transaction becomes InDoubt.

Commit() est appelé et la transaction est restaurée pour la première fois.Commit() is called and the transaction rolls back for the first time.

Remarques

Lorsque cette méthode est appelée, tous les objets qui ont été inscrits pour participer à la transaction sont interrogés et peuvent indiquer indépendamment leur vote pour valider ou restaurer la transaction.When this method is called, all objects that have registered to participate in the transaction are polled and can independently indicate their vote to either commit or roll back the transaction. Si un participant vote pour restaurer la transaction, il est restauré et cette méthode lève une exception TransactionException.If any participant votes to roll back the transaction, it is rolled back and this method throws a TransactionException exception. Il s’agit d’une occurrence normale pour une transaction et votre code doit intercepter et traiter ces exceptions.This is a normal occurrence for a transaction and your code should catch and process such exceptions.

Commit et EndCommit blocage jusqu’à ce que la première phase du traitement des transactions soit terminée.Commit and EndCommit block until the first phase of transaction processing is complete. La première phase se termine une fois que tous les gestionnaires de ressources et les inscriptions de la transaction ont voté sur le résultat de la transaction et que la TransactionManager a durablement décidé de valider ou d’abandonner la transaction.The first phase ends after all resource managers and enlistments in the transaction have voted on the transaction outcome and the TransactionManager has durably decided to commit or abort the transaction. La deuxième phase de traitement est toujours asynchrone.The second phase of processing is always asynchronous. Par conséquent, il n’existe aucune garantie que les données simplement validées à partir d’une transaction donnée soient immédiatement disponibles par la suite quand vous n’utilisez pas une autre transaction pour afficher ces données.Therefore, there is no guarantee that data just committed from within a given transaction will be immediately available afterwards when not using another transaction to view this data.

Étant donné que cette méthode bloque jusqu’à ce que la première phase du traitement de la transaction soit terminée, vous devez être extrêmement prudent lors de l’utilisation de cette méthode dans une application Windows Form (WinForm), ou un blocage peut se produire.Because this method blocks until the first phase of transaction processing is complete, you should be extremely careful when using this method in a Windows Form (WinForm) application, or a deadlock can occur. Si vous appelez cette méthode dans un événement de contrôle WinForm (par exemple, en cliquant sur un bouton) et que vous utilisez la méthode synchrone Invoke pour demander au contrôle d’effectuer des tâches d’interface utilisateur (par exemple, modifier des couleurs) au milieu du traitement de la transaction, un blocage se produit.If you call this method inside one WinForm Control event (for example, clicking a button), and use the synchronous Invoke method to direct the control to perform some UI tasks (for example, changing colors) in the middle of processing the transaction, a deadlock will happen. Cela est dû au fait que la méthode Invoke est synchrone et bloque le thread de travail jusqu’à ce que le thread d’interface utilisateur termine son travail.This is because the Invoke method is synchronous and blocks the worker thread until the UI thread finishes its job. Toutefois, dans notre scénario, le thread d’interface utilisateur attend également que le thread de travail valide la transaction.However, in our scenario, the UI thread is also waiting for the worker thread to commit the transaction. Le résultat est qu’aucun ne peut continuer et que l’étendue attend indéfiniment que la validation se termine.The result is that none is able to proceed and the scope waits indefinitely for the Commit to finish. Vous devez utiliser BeginInvoke plutôt que Invoke dans la mesure du possible, car elle est asynchrone et donc moins sujette aux verrous mortels.You should use BeginInvoke rather than Invoke wherever possible, because it is asynchronous and thus less prone to deadlock.

S’applique à