Метод UpdateBatch

Записывает все ожидающие пакетные обновления на диск.

Синтаксис

  
recordset.UpdateBatch AffectRecords, PreserveStatus  

Параметры

AffectRecords
Необязательно. Значение AffectEnum , указывающее, сколько записей будет влиять на метод UpdateBatch .

СохранитьStatus
Необязательно. Логическое значение, указывающее, должны ли быть зафиксированы локальные изменения, указанные свойством Status. Если это значение имеет значение True, свойство Status каждой записи остается неизменным после завершения обновления.

Замечания

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

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

Замечание

Указание adAffectGroup в качестве значения этого параметра приведет к ошибке, если в текущем наборе записей отсутствуют видимые записи (например, фильтр, для которого записи не совпадают).

Если попытка передачи изменений завершается ошибкой для любых или всех записей из-за конфликта с базовыми данными (например, запись уже удалена другим пользователем), поставщик возвращает предупреждения в коллекцию ошибок и возникает ошибка во время выполнения. Используйте свойство Filter (adFilterAffectedRecords) и свойство Status для поиска записей с конфликтами.

Чтобы отменить все ожидающие пакетные обновления, используйте метод CancelBatch .

Если заданы динамические свойства Unique Table и Update Resync , и набор записей является результатом выполнения операции JOIN в нескольких таблицах, то за выполнением метода UpdateBatch неявно следует метод Resync в зависимости от параметров свойства Update Resync .

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

Применимо к

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

См. также

Методы UpdateBatch и CancelBatch (VB)
Пример методов UpdateBatch и CancelBatch (VC++)
Метод CancelBatch (ADO)
Метод Clear (ADO)
свойство LockType (ADO)
метода обновления