Méthode de clonage ADO


❮ Référence complète de l'objet Recordset

La méthode Clone vous permet de créer un jeu d'enregistrements en double à partir d'un jeu d'enregistrements existant. Vous pouvez utiliser cette méthode pour créer plusieurs jeux d'enregistrements en double, en particulier si vous souhaitez modifier plusieurs enregistrements en cours dans un ensemble d'enregistrements. Cette méthode est beaucoup plus efficace que la création, l'ouverture et la fermeture d'un nouveau jeu d'enregistrements égal à l'original.

Lorsque vous clonez un jeu d'enregistrements, vous créez simplement un nouveau pointeur vers le même jeu d'enregistrements. Par conséquent, toutes les modifications que vous apportez à un jeu d'enregistrements seront visibles dans tous ses clones. Cependant, si vous exécutez une Requery sur le Recordset d'origine, les clones ne seront plus synchronisés avec l'original.

Le fournisseur doit prendre en charge les signets sur l'objet Recordset pour créer des clones. Les signets sont interchangeables ; une référence de signet d'un objet Recordset fait référence au même enregistrement dans l'un de ses clones.

Remarque : Le filtre du jeu d'enregistrements d'origine ne sera pas appliqué au clone. Pour copier un filtre existant : objRecordsetNew.Filter=objRecordsetOriginal.Filter

Remarque : lorsque vous fermez le jeu d'enregistrements d'origine, aucune des copies n'est fermée. Vous devrez fermer les clones un par un.

Syntaxe

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

Valeurs LockTypeEnum

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

❮ Référence complète de l'objet Recordset