Método CopyRecord (ADO)
Se aplica a: Access 2013, Office 2013
Copia una entidad representada por un objeto Record en otra ubicación.
Sintaxis
Graba. CopyRecord (Source, Destination, UserName, Password, Options, Async)
Parámetros
| Parámetro | Descripción |
|---|---|
| Source | Es opcional. Valor de tipo String con la dirección URL que especifica la entidad que se va a copiar (por ejemplo, un archivo o directorio). Si se omite Source o especifica una cadena vacía, se copiará el archivo o directorio representado por el actual objeto Record. |
| Destino | Opcional. Valor de tipo String con la dirección URL que especifica la ubicación en la que se va a copiar Source. |
| UserName | Opcional. Valor de tipo String con el identificador de usuario que, en caso de que sea necesario, autoriza el acceso a Destination. |
| Password | Opcional. Valor de tipo String con la contraseña que, en caso de que sea necesario, comprueba UserName. |
| Opciones | Es opcional. Valor de CopyRecordOptionsEnum que tiene adCopyUnspecified como valor predeterminado. Especifica el comportamiento de este método. |
| Async | Es opcional. Valor de tipo Boolean que, cuando es True, especifica que esta operación debe ser asincrónica. |
Valor devuelto
Valor de tipo String que normalmente devuelve el valor de Destination. Sin embargo, el valor devuelto exacto depende del proveedor.
Comentarios
Los valores de Source y Destination no pueden ser idénticos; en caso contrario, se produce un error en tiempo de ejecución. Al menos uno de los nombres de servidor, ruta de acceso o recurso debe ser diferente.
Todos los elementos secundarios de Source (por ejemplo, subdirectorios) se copian de forma recursiva, a menos que se especifique adCopyNonRecursive. En una operación recursiva, Destination no puede ser un subdirectorio de Source; en caso contrario, la operación no finalizará.
Este método genera un error si Destination identifica una entidad existente (por ejemplo, un archivo o directorio), a menos que se especifique adCopyOverWrite.
Importante
Utilice la opción adCopyOverWrite con criterio. Por ejemplo, si especifica esta opción cuando copia un archivo en un directorio, se eliminará el directorio y se reemplazará con el archivo.
Nota:
[!NOTA] Las direcciones URL que utilizan el esquema http llamarán automáticamente a Microsoft OLE DB Provider for Internet Publishing. Para obtener más información, consulte Direcciones URL absolutas y relativas.