Метод обновления

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

Синтаксис

  
recordset.Update Fields, Values  
record.Fields.Update  

Параметры

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

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

Замечания

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

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

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

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

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

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

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

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

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

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

Запись

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

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

Применимо к

Коллекция полей (ADO)

объекта набора записей

См. также

Пример методов Update и CancelUpdate (VB)
Пример методов Update и CancelUpdate (VC++)
метода AddNew (ADO)
Метод CancelUpdate (ADO)
Свойство EditMode
метода UpdateBatch