Метод UpdateBatch (ADO)

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

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

Синтаксис

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

Параметры

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

Замечания

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

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

Примечание.

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

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

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

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

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