Clone Method

The Clone method on a Recordset object creates a duplicate Recordset object from an existing Recordset object.

rstDuplicate = rstOriginal.Clone
 

Parameters

rstDuplicate
This object variable specifies the duplicate Recordset object to be created.
rstOriginal
This object variable specifies the Recordset object to be duplicated.

Remarks

The Clone method is used on a Recordset object to create multiple, duplicate Recordset objects, particularly if you want to be able to maintain more than one current record in a given set of records. Using the Clone method is more efficient than creating and opening a new Recordset object with the same definition as the original.

The current record of a newly created clone is set to the first record.

Changes made to one Recordset object are visible in all of its clones regardless of cursor type. However, after you execute Requery on the original Recordset, the clones will no longer be synchronized to the original.

Closing the original Recordset does not close its copies; closing a copy does not close the original or any of the other copies.

You can only clone a Recordset object that supports bookmarks. Bookmark values are interchangeable; that is, a bookmark reference from one Recordset object refers to the same record in any of its clones.