tutoriais mais recente desenvolvimento web
 

ADO Método Clone


<Completa Recordset Object Reference

O método Clone permite criar um conjunto de registos duplicados a partir de um conjunto de registos existente. Você pode usar esse método para criar múltiplos, duplicar registros, especialmente se você quiser 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 conjunto de registros igual ao original.

Quando você clonar um conjunto de registros que você realmente apenas criar um novo ponteiro para o mesmo conjunto de registros, portanto, todas as alterações feitas a um conjunto de registos será visível em todos os seus clones. No entanto, se você executar um Requery no conjunto de registros original, os clones não será mais sincronizado com o original.

O provedor deve suportar marcadores no objeto Recordset para criar clones. Marcadores são intercambiáveis; um indicador de referência a partir de um conjunto de registos objecto refere-se ao mesmo ficha em qualquer um dos seus clones.

Note: O filtro do conjunto de registros original não será aplicado ao clone. Para copiar um filtro existente: objRecordsetNew.Filter = objRecordsetOriginal.Filter

Note: Quando você fechar a nenhum conjunto de registos original das cópias será fechada. Você terá que fechar o clones por um.

Sintaxe

Set objRecordsetClone=objRecordset.Clone(locktype)

Parâmetro Descrição
objRecordsetClone O conjunto de registros clone a ser criado
objRecordset O conjunto de registos para ser clonado
locktype Opcional. Um LockTypeEnum valor que especifica o tipo de bloqueio

Valores LockTypeEnum

Constante Valor Descrição
adLockUnspecified-1 O clone é criado com o mesmo tipo de bloqueio como o de registos original
adLockReadOnly1 O clone é um conjunto de registos só de leitura

<Completa Recordset Object Reference