Tutorials References Menu

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