Метод Update

  • Статья

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

Синтаксис

  
recordset.Update Fields, Values  
record.Fields.Update

Параметры

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

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

Комментарии

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

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

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

  • Назначьте значения свойству Value объекта Field и вызовите метод Update.

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

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

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

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

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

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

Record

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

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

Применение

Коллекция Fields (ADO)

Объект Recordset (ADO)

См. также:

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