Name
Recordset.CancelBatch Method — (Versions 2.0, 2.1, 2.5, 2.6)
Synopsis
recordset.CancelBatch AffectRecords
The CancelBatch method cancels the currently pending batch update for the current Recordset object.
Arguments
-
AffectRecords(AffectEnum) Optional. Enumerator with the value of
adAffectCurrent,adAffectGroup, oradAffectAll.If the value of
AffectRecordsisadAffectCurrent, the CancelBatch method call affects only the pending updates for the current record of the recordset.If the value of
AffectRecordsisadAffectGroup, the CancelBatch method call affects only the pending records that are dictated through the Filter property of the current Recordset object. This property must be already set for the CancelBatch method to be called with theadAffectGroupparameter.If the value of
AffectRecordsisadAffectAll, all records pending updates within the current Recordset object (including those hidden by the Filter property) are affected by the CancelBatch method.
Description
With the CancelBatch method, you can cancel any or all pending updates in the current Recordset object from batch update mode; however, in immediate update mode, calling this method will generate an error.
The CancelUpdate method is called when the CancelBatch method is called, thus removing any updates or new records that were added within the batch. For this reason, the current record position may be invalid, and it is suggested that you move to a reliable record position, either by a valid bookmark or by using ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access