Compartilhar via

Método CopyRecord (ADO)

  • Artigo

Copia uma entidade representada por um registro para outro local.

Sintaxe

  
Record.CopyRecord (Source, Destination, UserName, Password, Options, Async)

Parâmetros

Origem
Opcional. Um valor String que contém uma URL que especifica a entidade a ser copiada (por exemplo, um arquivo ou diretório). Se Source for omitido ou especificar uma cadeia de caracteres vazia, o arquivo ou diretório representado pelo Record atual será copiado.

Destino
Opcional. Um valor String que contém uma URL que especifica o local em que Source será copiado.

UserName
Opcional. Um valor String que contém a ID do usuário que, se necessário, autoriza o acesso a Destination.

Senha
Opcional. Um valor String que contém a senha que, se necessário, verifica UserName.

Opções
Opcional. Um valor CopyRecordOptionsEnum que tem um valor padrão de adCopyUnspecified. Especifica o comportamento deste método.

Async
Opcional. Um valor Boolean que, quando True, especifica que essa operação deve ser assíncrona.

Valor Retornado

Um valor String que normalmente retorna o valor de Destination. No entanto, o valor exato retornado depende do provedor.

Comentários

Os valores de Source e Destination não devem ser idênticos; caso contrário, ocorrerá um erro em tempo de execução. Pelo menos um dos nomes de servidor, caminho ou recurso deve ser diferente.

Todos os filhos (por exemplo, subdiretórios) de Source são copiados recursivamente, a menos que adCopyNonRecursive seja especificado. Em uma operação recursiva, Destination não deve ser um subdiretório de Source; caso contrário, a operação não será concluída.

Esse método falhará se Destination identificar uma entidade existente (por exemplo, um arquivo ou diretório), a menos que adCopyOverWrite seja especificado.

Importante

Use a opção adCopyOverWrite criteriosamente. Por exemplo, especificar essa opção ao copiar um arquivo para um diretório vai excluir o diretório e substituí-lo pelo arquivo.

Observação

As URLs que usam o esquema HTTP invocarão automaticamente o Provedor Microsoft OLE DB para Publicação na Internet. Para obter mais informações, confira URLs absolutas e relativas.

Aplica-se A

Objeto Record (ADO)