Microsoft SDK for Java

clone

The clone method of the Recordset class creates a duplicate Recordset object from an existing Recordset object. Optionally, it specifies that the clone be read-only. clone has the following signatures:

clone()
clone(int lockType)

Remarks

Use the clone method 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 you make to one Recordset object are visible in all its clones regardless of cursor type. However, once 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; nor does closing a copy 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.

clone()

Creates a duplicate Recordset object from an existing Recordset object.

Syntax

public Object clone();

Return Value

Returns a Recordset object reference.

clone(int lockType)

Creates a duplicate Recordset object from an existing Recordset object.

Syntax

public Object clone(int lockType);

Return Value

Returns a Recordset object reference.

Parameters

lockType A AdoEnums.LockType value that specifies either the lock type of the original Recordset, or a read-only Recordset. Valid values are UNSPECIFIED or READONLY.

© 1999 Microsoft Corporation. All rights reserved. Terms of use.