ADO UpdateBatch Method
 Complete Recordset Object Reference
The UpdateBatch method is used to save all changes in a Recordset to the database. This
method is used when you are working on a Recordset in batch update mode.
If the save operation fails, a
run-time error occurs and the errors are stored in the Errors collection.
Tip: The CancelBatch method cancels all batch updates.
Note: Not all Recordset objects supports batch updating.
Syntax
bool=objRecordset.UpdateBatch affectrecords
|
| Parameter |
Description |
| affectrecords |
Optional. An AffectEnum value
that specifies which records this method will affect.
Note: The value adAffectGroup will generate an error if there
are no visible records in the Recordset
|
AffectEnum Values
| Constant |
Value |
Description |
| adAffectCurrent |
1 |
Affects only the current record |
| adAffectGroup |
2 |
Affects only records that satisfy the Filter setting (Filter must be
set to a FilterGroupEnum
value or an array of Bookmarks) |
| adAffectAll |
3 |
Affects all records if there is no Filter. Affects only visible
records in the current chapter if Filter is set to a string criteria.
Affect all rows of the Recordset if Filter is set to a FilterGroupEnum
value or an array of Bookmarks
|
| adAffectAllChapters |
4 |
Affects all records in all child Recordset, including those hidden
by a currently applied filter |
Complete Recordset Object Reference
|
|
|
