DevGuru ADO Recordset::UpdateBatch Method

Quick References

Features

Partners

METHOD: Recordset::UpdateBatch

Boolean = recordsetobject.UpdateBatch (AffectRecords)

The UpdateBatch method is called to save to the data source all of the pending changes and additions that have occurred in a Recordset object since the last update.

Clearly, the Recordset must support batch updating. When a Recordset is in batch updating mode, all of the changes and new additions are saved in a local cache until the BatchUpdate method is called. (The LockType property of the Recordset object must return the adLockBatchOptimistic constant which specifies that multiple users can modify the data and that all changes are locally cached.)

If all or part of the UpdateBatch fails, a warning is returned to the Errors Collection and an error is generated.

You can cancel a BatchUpdate by calling the CancelBatch method.

There is one optional parameter.

The optional AffectRecords parameter is one of the AffectEnum constants that specifies which records are to be affected.

AffectEnum Constants

Constant	Value	Description
adAffectAll	3	Update all records including those hidden by a filter
adAffectAllChapters	-	Not recognized by this method
adAffectCurrent	1	Update only the current record
adAffectGroup	2	Update only those records that passed through the filter in effect

Code (VBScript):
If MsgBox("Batch Save All Changes", vbYesNo) = vbYes Then
   objRecordset.UpdateBatch
   MsgBox "All Changes Updated"
Else
   objRecordset.CancelBatch
   MsgBox "All Changes Cancelled"
End If