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
Need an easy way to get data into XML, or transform XML to another format?
MapForce lets you map XML data to/from any combination of XML, database, flat file, Excel 2007, XBRL, or Web services data.
Then it transforms data instantly or auto-generates royalty-free data integration code for recurrent conversions.
Download a free, fully functional 30-day trial to experience the following features:
- Easy-to-use, graphical data mapping interface
- Instant data transformation
- XSLT 1.0/2.0 and XQuery code generation
- Java, C#, and C++ code generation
- Advanced data processing functions
- Support for all major relational databases including SQL Server, IBM DB2, Oracle, and more
- Visual Studio & Eclipse integration
Download a fully-functional trial today!
|
|
|
|
