Método CopyRecord (ADO)
Aplica-se ao: Access 2013, Office 2013
Copia uma entidade representada por um Record para outro local.
Sintaxe
Gravar. CopyRecord (Source, Destination, UserName, Password, Options, Async)
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Source | 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 sequência 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 o ID de usuário que, se necessário, autoriza acesso ao Destination. |
| Password | Opcional. Um valor String que contém a senha que, se necessária, verifica UserName. |
| Options | Opcional. Um valor CopyRecordOptionsEnum que tem o valor padrão adCopyUnspecified. Especifica o comportamento deste método. |
| Async | Opcional. Um valor Boolean que, quando é True, especifica que esta operação deve ser assíncrona. |
Valor de retorno
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.
Este método falha se Destination identificar uma entidade existente (por exemplo, um arquivo ou diretório), a menos que adCopyOverWrite seja especificado.
Importante
Utilize a opção adCopyOverWrite criteriosamente. Por exemplo, especificar essa opção ao copiar um arquivo para um diretório irá excluir o diretório e substituí-lo pelo arquivo.
Observação
[!OBSERVAçãO] URLs using the http scheme will automatically invoke the Microsoft OLE DB Provider for Internet Publishing. Para obter mais informações, consulte URLs absolutas e relativas.