Método de clone ADO
❮ Referência Completa do Objeto do Conjunto de Registros
O método Clone permite que você crie um Recordset duplicado de um Recordset existente. Você pode usar esse método para criar vários conjuntos de registros duplicados, principalmente se desejar editar mais de um registro atual em um conjunto de registros. Este método é muito mais eficiente do que criar, abrir e fechar um novo Recordset igual ao original.
Quando você clona um Recordset, na verdade apenas cria um novo ponteiro para o mesmo Recordset, portanto, quaisquer alterações feitas em um Recordset serão visíveis em todos os seus clones. No entanto, se você executar uma Requery no Recordset original, os clones não serão mais sincronizados com o original.
O provedor deve oferecer suporte a marcadores no objeto Recordset para criar clones. Os marcadores são intercambiáveis; uma referência de marcador de um objeto Recordset refere-se ao mesmo registro em qualquer um de seus clones.
Nota: O filtro do Recordset original não será aplicado ao clone. Para copiar um filtro existente: objRecordsetNew.Filter=objRecordsetOriginal.Filter
Nota: Ao fechar o Recordset original, nenhuma das cópias será fechada. Você terá que fechar os clones um por um.
Sintaxe
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 |
Valores 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 |
❮ Referência Completa do Objeto do Conjunto de Registros