Метод CancelUpdate (ADO)

Область применения: Access 2013, Office 2013

Отменяет любые изменения, внесенные в текущую или новую строку объекта Recordset или коллекцию Fields объекта Record , перед вызовом метода Update .

Синтаксис

набор записей. CancelUpdate

запись. Поля. CancelUpdate

Замечания

Recordset

Используйте метод CancelUpdate , чтобы отменить любые изменения, внесенные в текущую строку, или отменить добавленную строку. Изменения в текущей строке или новой строке нельзя отменить после вызова метода Update , если изменения не являются частью транзакции, которую можно выполнить с помощью метода RollbackTrans , или частью пакетного обновления. В случае пакетного обновления обновление можно отменить с помощью метода CancelUpdate или CancelBatch .

При добавлении новой строки при вызове метода CancelUpdate текущая строка становится текущей строкой до вызова AddNew .

Если вы находитесь в режиме редактирования и хотите отключить текущую запись (например, с помощью move, NextRecordset или Close), можно отменить все ожидающие изменения с помощью cancelUpdate . Это может потребоваться, если обновление не может быть успешно опубликовано в источнике данных (например, попытка удаления, которая завершается сбоем из-за нарушений целостности ссылок, приведет к тому, что набор записей будет находиться в режиме редактирования после вызова delete).

Запись

Метод CancelUpdate отменяет все ожидающие вставки или удаления объектов Field , а также отменяет ожидающие обновления существующих полей и восстанавливает их исходные значения. Свойство Status для всех полей в коллекции Fields имеет значение adFieldOK.