Clone メソッド

既存の Recordset オブジェクトから Recordset オブジェクトの複製 (クローン) を作成します。

構文

Set duplicate = original. Clone

Clone メソッドの構文には、次の指定項目があります。

指定項目	説明
duplicate	複製により作成される Recordset オブジェクトを示すオブジェクト変数です。
original	複製元の Recordset オブジェクトを示すオブジェクト変数です。

解説

Clone メソッドは、あるレコードのセットで複数のカレント レコードを扱いたい場合などに、複数個の Recordset オブジェクトを複製するために使います。Clone メソッドを使えば、元のものと同じ定義を持つ新しい Recordset オブジェクトを作成して開くよりも簡単に Recordset オブジェクトを複製できます。

新しく作成されたクローンのカレント レコードは、先頭のレコードに設定されます。ある Recordset オブジェクトに対して変更を加えると、そのカーソル タイプに関係なく、ほかのすべてのクローンに対してもその変更が有効になります。元のレコードセットを閉じても、そのクローンがともに閉じるわけではありません。また、あるクローンを閉じても、その元のレコードセットやほかのクローンがともに閉じるわけではありません。

クローンを作成できるのは、ブックマークをサポートしている Recordset オブジェクトだけです。ブックマーク値は互いに代用することができます。つまり、ある Recordset オブジェクトからブックマークを参照すると、ほかのすべてのクローンの中にある同じレコードを参照することになります。

対象

Recordset