Метод CancelBatch (ADO)
Отменяет ожидающее пакетное обновление.
Синтаксис
recordset.CancelBatchAffectRecords
Параметры
AffectRecords
Необязательный элемент. Значение AffectEnum , указывающее, сколько записей повлияет метод CancelBatch .
Комментарии
Используйте метод CancelBatch , чтобы отменить все ожидающие обновления в наборе записей в режиме пакетного обновления. Если набор записей находится в режиме немедленного обновления, вызов CancelBatch без adAffectCurrent приведет к ошибке.
Если вы изменяете текущую запись или добавляете новую запись при вызове CancelBatch, ADO сначала вызывает метод CancelUpdate , чтобы отменить все кэшированные изменения. После этого все ожидающие изменения в наборе записей будут отменены.
Текущая запись может быть неопределенной после вызова CancelBatch , особенно если вы добавили новую запись. По этой причине целесообразно установить текущее положение записи в известное расположение в наборе записей после вызова CancelBatch . Например, вызовите метод MoveFirst .
Если попытка отменить ожидающие обновления завершается сбоем из-за конфликта с базовыми данными (например, если запись была удалена другим пользователем), поставщик возвращает предупреждения в коллекцию Errors , но не останавливает выполнение программы. Ошибка во время выполнения возникает только при наличии конфликтов во всех запрошенных записях. Используйте свойство Filter (adFilterAffectedRecords) и свойство Status для поиска записей с конфликтами.
Применение
См. также:
Пример использования методов UpdateBatch и CancelBatch (VB)
Примеры методов UpdateBatch и CancelBatch (Visual C++)
Метод Cancel (ADO)
Метод Cancel (служба удаленных рабочих столов)
Метод CancelUpdate (ADO)
Метод CancelUpdate (служба удаленных рабочих столов)
Метод Clear (ADO)
Свойство LockType (ADO)
Метод UpdateBatch