Méthode CancelUpdate (ADO)

S’applique à : Access 2013, Office 2013

Annule toutes les modifications apportées à la ligne active ou à une nouvelle ligne d’un objet Recordset ou dans la collection Fields d’un objet Record avant que la méthode Update soit appelée.

Syntaxe

recordset. CancelUpdate

enregistrement. Champs. CancelUpdate

Remarques

Recordset

Faites appel à la méthode CancelUpdate pour annuler les modifications apportées à la ligne active ou pour supprimer la ligne que vous venez d'ajouter. Vous ne pouvez pas effectuer ces opérations après avoir appelé la méthode Update sauf si ces modifications font partie d'une transaction que vous pouvez annuler à l'aide de la méthode RollbackTrans ou d'une mise à jour par lot. Dans ce dernier cas, vous pouvez annuler la méthode Update à l'aide de la méthode CancelUpdate ou CancelBatch.

Si vous ajoutez une nouvelle ligne, lorsque vous appelez la méthode CancelUpdate, la ligne active représente celle qui était active avant l'appel de la méthode AddNew.

Si vous êtes en mode édition et que vous voulez quitter l'enregistrement actif (par exemple, en utilisant Move, NextRecordset ou Close), vous pouvez faire appel à la méthode CancelUpdate pour annuler les modifications en attente. Cette opération est nécessaire si la mise à jour ne peut pas être publiée dans la source de données (par exemple, une tentative de suppression qui échoue suite à des violations de l'intégrité du référentiel laisse l'objet Recordset en mode édition après un appel de Delete).

Objet Record

La méthode CancelUpdate annule toute insertion ou suppression en attente d'objets Field, ainsi que les mises à jour en attente des champs existants et rétablit leurs valeurs d'origine. La propriété Status de tous les champs de la collection Fields a la valeur adFieldOK.