Поделиться через

Метод CancelBatch (ADO)

  • Статья

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

Отменяет ожидающее пакетное обновление.

Синтаксис

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

Параметры

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

Замечания

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

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

Возможно, текущая запись будет неопределимой после вызова CancelBatch , особенно если вы находились в процессе добавления новой записи. По этой причине разумно задать текущее положение записи в известном расположении в наборе записей после вызова CancelBatch . Например, вызовите метод MoveFirst .

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