W3Schools.com

ADO Clone Method

Recordset Object Reference 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

Recordset Object Reference Complete Recordset Object Reference
W3Schools Certification

W3Schools' Online Certification

The perfect solution for professionals who need to balance work, family, and career building.

More than 10 000 certificates already issued!

Get Your Certificate »

The HTML Certificate documents your knowledge of HTML.

The CSS Certificate documents your knowledge of advanced CSS.

The JavaScript Certificate documents your knowledge of JavaScript and HTML DOM.

The jQuery Certificate documents your knowledge of jQuery.

The XML Certificate documents your knowledge of XML, XML DOM and XSLT.

The ASP Certificate documents your knowledge of ASP, SQL, and ADO.

The PHP Certificate documents your knowledge of PHP and SQL (MySQL).

WEB HOSTING
Best Web Hosting
PHP MySQL Hosting
Best Hosting Coupons
UK Reseller Hosting
Cloud Hosting
Top Web Hosting
$7.95/mo SEO Hosting
Premium Website Design
WEB BUILDING
Download XML Editor
FREE Website BUILDER
Free Website Templates Free CSS Templates
Make Your Own Website
W3SCHOOLS EXAMS
Get Certified in:
HTML, CSS, JavaScript, XML, PHP, and ASP
W3SCHOOLS BOOKS
New Books:
HTML, CSS
JavaScript, and Ajax
STATISTICS
Browser Statistics
Browser OS
Browser Display
SHARE THIS PAGE