Méthode CancelBatch (ADO)

S’applique à : Access 2013, Office 2013

Annule une mise à jour par lot en attente.

Syntaxe

recordset. CancelBatch AffectRecords

Paramètres

Remarques

Utilisez la méthode CancelBatch pour annuler toutes les mises à jour en attente dans un objet Recordset en mode de mise à jour par lot. Si l'objet Recordset est en mode de mise à jour immédiate, l'appel de la méthode CancelBatch sans adAffectCurrent génère une erreur.

Si vous modifiez l'enregistrement actif ou que vous ajoutez un nouvel enregistrement lorsque vous appelez la méthode CancelBatch, ADO commence par appeler la méthode CancelUpdate pour annuler les modifications mises en cache. Ensuite, toutes les modifications en attente dans l'objet Recordset sont annulées.

Il se peut que l'enregistrement actif ne puisse pas être déterminé après un appel de la méthode CancelBatch, notamment si vous étiez en train d'ajouter un nouvel enregistrement. C'est pourquoi il est conseillé de définir la position de l'enregistrement actif à un emplacement connu de l'objet Recordset après avoir appelé la méthode CancelBatch. Appelez, par exemple, la méthode MoveFirst.

Si la tentative d'annulation des mises à jour en attente échoue à cause d'un conflit avec les données sous-jacentes (par exemple, un enregistrement a été supprimé par un autre utilisateur), le fournisseur retourne des avertissements dans la collection Errors, mais n'interrompt pas l'exécution. Une erreur d’exécution ne se produit qu’en cas de conflits dans tous les enregistrements demandés. Utilisez les propriétés Filter (adFilterAffectedRecords) et Status pour localiser les enregistrements en conflit.