CancelBatch, méthode (ADO)
Annule une mise à jour par lots en attente.
Syntaxe
recordset.CancelBatchAffectRecords
Paramètres
AffectRecords
Optionnel. Valeur AffectEnum qui indique le nombre d’enregistrements que la méthode CancelBatch affectera.
Remarques
Utilisez la méthode CancelBatch pour annuler les mises à jour en attente dans un jeu d’enregistrements en mode de mise à jour par lots. Si le recordset de est en mode de mise à jour immédiate, l’appel 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 le jeu d’enregistrements 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 le jeu d’enregistrements 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 n’interrompt pas l’exécution du programme. Une erreur d’exécution se produit uniquement 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 avec des conflits.
S’applique à
Voir aussi
UpdateBatch et CancelBatch, méthodes - Exemple (VB)
UpdateBatch et CancelBatch, méthodes - Exemple (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)
méthode UpdateBatch