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