既存の Recordset オブジェクトから Recordset オブジェクトの複製を作成します。必要に応じて、複製を読み取り専用に指定できます。
構文
Set rstDuplicate = rstOriginal.Clone (LockType)
戻り値
Recordset オブジェクトへの参照を返します。
パラメータ
rstDuplicate 作成する Recordset オブジェクトの複製を表すオブジェクト変数を指定します。
rstOriginal 複製元の Recordset オブジェクトを表すオブジェクト変数を指定します。
LockType 省略可能です。複製元の Recordset オブジェクトのロックの種類を適用するか、または読み取り専用にするかを LockTypeEnum 値で指定します。有効な値は、adLockUnspecified または adLockReadOnly です。
解説
Clone メソッドを使って、Recordset オブジェクトの複製を複数作成します。特に、レコード セットの複数のカレント レコードを維持する場合に、このメソッドを使用します。Clone メソッドを使うと、同じ定義を設定して新規 Recordset オブジェクトを作成して開くよりも効率的です。
作成したクローンのカレント レコードは、最初のレコードに設定されます。
1 つの Recordset オブジェクトに加えた変更は、カーソル タイプにかかわらず、すべてのクローンで参照できます。ただし、複製元の Recordset オブジェクトで Requery を実行した後は、クローンは複製元の Recordset オブジェクトと同期しなくなります。
複製元のレコードセットを閉じても、そのクローンは開いたままです。また、クローンを閉じても、複製元またはほかのクローンは開いています。
ブックマークをサポートする Recordset オブジェクトのみクローンを作成することができます。ブックマークの値は共通です。したがって、1 つの Recordset オブジェクトのブックマークで、すべてのクローンの同じレコードを参照できます。