Метод Update

Сохраняет любые изменения, внесенные в текущую строку объекта набора записей , или коллекцию Fields объекта Record .

Синтаксис

  
recordset.Update Fields, Values  
record.Fields.Update  

Параметры

Fields
Необязательный параметр. Вариант , представляющий одно имя или массив Variant , представляющий имена или порядковые позиции поля или полей, которые требуется изменить.

Значения
Необязательный элемент. Вариант , представляющий одиночное значение, или массив Variant , представляющий значения для поля или полей в новой записи.

Комментарии

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

Используйте метод Update , чтобы сохранить изменения, внесенные в текущую запись объекта набора записей , с момента вызова метода AddNew или изменения любых значений полей в существующей записи. Объект набора записей должен поддерживать обновления.

Чтобы задать значения полей, выполните одно из следующих действий.

  • Присвойте значения свойству значения объекта поля и вызовите метод Update .

  • Передайте имя поля и значение в качестве аргументов в вызове Update .

  • Передайте массив имен полей и массив значений с помощью вызова Update .

При использовании массивов полей и значений должно быть одинаковое число элементов в обоих массивах. Кроме того, порядок имен полей должен совпадать с порядком значений полей. Если число и порядок полей и значений не совпадают, возникает ошибка.

Если объект Recordset поддерживает пакетное обновление, можно кэшировать несколько изменений в одной или нескольких записях локально, пока не будет вызван метод UpdateBatch . Если вы изменяете текущую запись или добавляете новую запись при вызове метода UpdateBatch , ADO автоматически вызывает метод Update , чтобы сохранить все ожидающие изменения в текущей записи перед передачей пакетных изменений поставщику.

Если вы перейдете из записи, которая добавляется или редактируется перед вызовом метода Update , то ADO автоматически вызовет Update для сохранения изменений. Если необходимо отменить все изменения, внесенные в текущую запись, или удалить вновь добавленную запись, необходимо вызвать метод CancelUpdate .

Текущая запись остается текущей после вызова метода Update .

Record

Метод Update завершает Добавление, удаление и обновление полей в коллекции Fields объекта Record .

Например, поля, удаленные с помощью метода Delete , помечаются для удаления немедленно, но остаются в коллекции. Для фактического удаления этих полей из коллекции поставщика необходимо вызвать метод Update .

Применяется к

См. также:

Примеры методов Update и CancelUpdate (Visual Basic)
Примеры методов Update и CancelUpdate (VC++)
Метод AddNew (ADO)
Метод CancelUpdate (ADO)
EditMode, свойство
Метод UpdateBatch