Clone メソッド (ADO)Clone Method (ADO)

複製を作成しますRecordset既存のオブジェクトRecordsetオブジェクト。Creates a duplicate Recordset object from an existing Recordset object. 必要に応じて、複製が読み取り専用であることを指定します。Optionally, specifies that the clone be read-only.

構文Syntax

  
Set rstDuplicate = rstOriginal.Clone (LockType)  

戻り値Return Value

返します、 Recordsetオブジェクト参照。Returns a Recordset object reference.

パラメーターParameters

rstDuplicaterstDuplicate
重複を識別するオブジェクト変数Recordsetオブジェクトを作成します。An object variable that identifies the duplicate Recordset object to be created.

rstOriginalrstOriginal
オブジェクト変数を識別する、 Recordset重複するオブジェクト。An object variable that identifies the Recordset object to be duplicated.

LockTypeLockType
任意。Optional. A LockTypeEnum 、元のいずれか、ロックの種類を指定する値レコード セット、または読み取り専用Recordsetします。A LockTypeEnum value that specifies either the lock type of the original Recordset, or a read-only Recordset. 有効な値はadLockUnspecifiedまたはadLockReadOnlyします。Valid values are adLockUnspecified or adLockReadOnly.

コメントRemarks

使用して、複製複数作成するメソッドが重複していますレコード セットオブジェクトの場合、特定のレコード セットの 1 つ以上の現在のレコードを保持したい場合に特にです。Use the Clone method to create multiple, duplicate Recordset objects, especially if you want 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 that uses the same definition as the original.

フィルター 、元のプロパティレコード セット、複製には適用されません。The Filter property of the original Recordset, if any, will not be applied to the clone. 設定、フィルタープロパティの新しいRecordset結果をフィルター処理します。Set the Filter property of the new Recordset to filter the results. 既存のすべてのコピーを最も簡単な方法フィルター値は、次のように、直接割り当てることができます。The simplest way to copy any existing Filter value is to assign it directly, as follows.

rsNew.Filter = rsOriginal.Filter  

新しく作成された複製の現在のレコードは、最初のレコードに設定されます。The current record of a newly created clone is set to the first record.

いずれかに加えたRecordsetオブジェクトは、すべてのカーソルの種類に関係なく複製に表示されます。Changes you make to one Recordset object are visible in all of its clones regardless of cursor type. 実行した後、ただしRequery元のレコード セットクローンは元に不要になった同期します。However, after 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.

複製することしか、 Recordsetブックマークをサポートするオブジェクト。You can only clone a Recordset object that supports bookmarks. ブックマークの値を交換できます。1 つからのブックマーク参照は、レコード セットオブジェクトがその複製のいずれかで同じレコードを参照します。Bookmark values are interchangeable; that is, a bookmark reference from one Recordset object refers to the same record in any of its clones.

いくつかRecordsetすべてにもトリガーされるイベントが発生レコード セットのクローンを作成します。Some Recordset events that are triggered will also occur in all Recordset clones. ただし、現在のレコードが異なるため、複製レコード セットイベントは、複製の有効なできない可能性があります。However, because the current record can differ between cloned Recordsets, the events may not be valid for the clone. たとえば、フィールドの値を変更する場合、 WillChangeFieldで、変更されたイベントが発生レコード セットとすべてのクローンで。For example, if you change a value of a field, a WillChangeField event will occur in the changed Recordset and in all clones. フィールドのパラメーター、 WillChangeFieldの複製されたイベントRecordset (場所は変更されませんでした) は、複製の現在のレコードのフィールドを参照元の現在のレコードより別のレコードであるレコード セット変更が発生しました。The Fields parameter of the WillChangeField event of a cloned Recordset (where the change was not made) will refer to the fields of the current record of the clone, which may be a different record than the current record of the original Recordset where the change occurred.

次の表は、すべての完全な一覧Recordsetイベント。The following table provides a full listing of all Recordset events. 有効でを使用して生成されたすべてのレコード セットの複製のトリガーされたかどうかを示します、複製メソッド。It indicates whether they are valid and triggered for any recordset clones generated by using the Clone method.

イベントEvent クローンで発生するでしょうか。Triggered in clones?
EndOfRecordsetEndOfRecordset いいえNo
FetchCompleteFetchComplete いいえNo
FetchProgressFetchProgress いいえNo
FieldChangeCompleteFieldChangeComplete はいYes
MoveCompleteMoveComplete いいえNo
RecordChangeCompleteRecordChangeComplete はいYes
RecordsetChangeCompleteRecordsetChangeComplete いいえNo
WillChangeFieldWillChangeField はいYes
WillChangeRecordWillChangeRecord はいYes
WillChangeRecordsetWillChangeRecordset いいえNo
WillMoveWillMove いいえNo

適用対象Applies To

Recordset オブジェクト (ADO)Recordset Object (ADO)

参照See Also

Clone メソッドの例 (VB) Clone Method Example (VB)
Clone メソッドの例 (VBScript) Clone Method Example (VBScript)
Clone メソッドの例 (VC++)Clone Method Example (VC++)