Метод CancelBatch (ADO)

  • Статья

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

Синтаксис

  
recordset.CancelBatchAffectRecords

Параметры

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

Комментарии

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

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

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

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

Применение

Объект Recordset (ADO)

См. также:

Пример использования методов UpdateBatch и CancelBatch (VB)
Примеры методов UpdateBatch и CancelBatch (Visual C++)
Метод Cancel (ADO)
Метод Cancel (служба удаленных рабочих столов)
Метод CancelUpdate (ADO)
Метод CancelUpdate (служба удаленных рабочих столов)
Метод Clear (ADO)
Свойство LockType (ADO)
Метод UpdateBatch