Метод Update (ADO)

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

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

Синтаксис

набор записей. Поля обновления, значения

запись. Поля. Обновление

Параметры

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

Замечания

Recordset

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

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

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

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

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

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

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

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

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

Запись

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

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