ADO: ActiveX Data Objects

Name

Recordset.Clone Method — (Versions 2.0, 2.1, 2.5, 2.6)

Synopsis

Set cloned_recordset = original_recordset.Clone

The Clone method of the Recordset object returns a clone of the current Recordset.

Returns

Recordset object

Description

The Clone method of the Recordset object creates an exact multiple copy of the original Recordset object. Use this method when you want to access more than one record at a time within the same recordset. This is more efficient than creating another new Recordset object for the same recordset.

When a clone is created, the clone’s record position will be set to the first record in the recordset.

Only recordsets that support bookmarks can be cloned. Bookmarks from one recordset are valid for clones of that recordset, and vice versa. Closing a clone does not close the original recordset, and vice versa.

See Also

LockTypeEnum Enumeration