ADO Clone Method
Complete Recordset Object Reference
The Clone method allows you to create a duplicate Recordset from an existing Recordset.
You can use this method to create multiple, duplicate Recordset, particularly if
you want to edit more than one current record in a set of records. This method
is much more efficient than creating, opening, and closing a new Recordset equal
to the original.
When you clone a Recordset you actually just create a new pointer to the same
Recordset, therefore any changes you make to one Recordset will be visible in all of its clones. However,
if you execute a Requery on the original Recordset, the clones will no longer be synchronized to the original.
The provider must support bookmarks on the Recordset object to create clones. Bookmarks are interchangeable;
a bookmark reference from one Recordset object refers to the same record in any of its clones.
Note: The filter of the original Recordset will not be applied to the clone.
To copy an existing filter: objRecordsetNew.Filter=objRecordsetOriginal.Filter
Note: When you close the original Recordset none of the copies will be
closed. You will have to close the clones one by one.
Syntax
Set objRecordsetClone=objRecordset.Clone(locktype)
|
Parameter |
Description |
objRecordsetClone |
The clone Recordset to be created |
objRecordset |
The Recordset to be cloned |
locktype |
Optional. A LockTypeEnum
value that specifies the lock type |
LockTypeEnum Values
Constant |
Value |
Description |
adLockUnspecified |
-1 |
The clone is created with
the same lock type as the original Recordset |
adLockReadOnly |
1 |
The clone is a read-only Recordset |
Complete Recordset Object Reference
…
|