CancelBatch, méthode (ADO)

  • Article

Annule une mise à jour par lot en attente.

Syntaxe

  
recordset.CancelBatchAffectRecords

Paramètres

AffectRecords
facultatif. Une valeur AffectEnum qui indique le nombre d’enregistrements affectés par la méthode CancelBatch.

Notes

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

Si vous modifiez l’enregistrement actif ou ajoutez un nouvel enregistrement lorsque vous appelez CancelBatch, ADO appelle d’abord la méthode CancelUpdate pour annuler les modifications mises en cache. Après cela, toutes les modifications en attente dans l’objet Recordset sont annulées.

L’enregistrement actif peut être indéterminable après un appel CancelBatch, en particulier si vous étiez dans le processus d’ajout d’un nouvel enregistrement. Pour cette raison, il est prudent de définir la position d’enregistrement actuelle sur un emplacement connu dans l’objet Recordset après l’appel CancelBatch. Par exemple, appelez la méthode MoveFirst.

Si la tentative d’annulation des mises à jour en attente échoue en raison d’un conflit avec les données sous-jacentes (par exemple, si un enregistrement a été supprimé par un autre utilisateur), le fournisseur retourne des avertissements à la collection Errors, mais ne cesse pas l’exécution du programme. Une erreur d’exécution ne se produit que s’il existe des conflits sur tous les enregistrements demandés. Utilisez la propriété Filter (adFilterAffectedRecords) et la propriété Status pour localiser les enregistrements en conflit.

S'applique à

Recordset, objet (ADO)

Voir aussi

UpdateBatch et CancelBatch, exemple de méthodes
UpdateBatch et CancelBatch, exemple de méthodes (VC++)
Cancel, méthode (ADO)
Cancel, méthode (RDS)
CancelUpdate, méthode (ADO)
CancelUpdate, méthode (RDS)
Clear, méthode (ADO)
LockType, propriété (ADO)
UpdateBatch, méthode