CancelUpdate, méthode (ADO)

  • Article

Annule toutes les modifications apportées à la ligne actuelle ou nouvelle d’un objet Recordset ou à la collection Fields d’un objet Record avant d’appeler la méthode Update.

Syntaxe

  
recordset.CancelUpdaterecord.Fields.CancelUpdate

Notes

Ensemble d'enregistrements

Utilisez la méthode CancelUpdate pour annuler les modifications apportées à la ligne active ou pour ignorer une ligne nouvellement ajoutée. Vous ne pouvez pas annuler les modifications apportées à la ligne actuelle ou une nouvelle ligne après avoir appelé la méthode Update, sauf si les modifications font partie d’une transaction que vous pouvez restaurer avec la méthode RollbackTrans ou une partie d’une mise à jour par lots. Dans le cas d’une mise à jour par lots, vous pouvez annuler la mise à jour avec la méthode CancelUpdate ou CancelBatch.

Si vous ajoutez une nouvelle ligne lorsque vous appelez la méthode CancelUpdate, la ligne active devient la ligne qui était active avant l’appel AddNew.

Si vous êtes en mode édition et que vous souhaitez désactiver l’enregistrement actif (par exemple, à l’aide des méthodes Move, NextRecordset ou Close), vous pouvez utiliser CancelUpdate pour annuler les modifications en attente. Vous devrez peut-être effectuer cette opération si la mise à jour ne peut pas être publiée avec succès dans la source de données. Par exemple, une tentative de suppression qui échoue en raison de violations d’intégrité référentielle laisse le Recordset en mode édition après un appel Delete.

Enregistrement

La méthode CancelUpdate annule toutes les insertions ou suppressions en attente d’objets Field, et annule les mises à jour en attente des champs existants et les restaure à leurs valeurs d’origine. La propriété Status de tous les champs de la collection Fields est définie sur adFieldOK.

S'applique à

Fields, collection (ADO)

Recordset, objet (ADO)

Voir aussi

Update et CancelUpdate, exemple de méthodes (VB)
Update et CancelUpdate, exemple de méthodes (VC++)
AddNew, méthode (ADO)
Cancel, méthode (ADO)
Cancel, méthode (RDS)
CancelBatch, méthode (ADO)
CancelUpdate, méthode (RDS)
EditMode, propriété
Update, méthode