CopyFile (Método)
Descripción
Copia uno o más archivos desde una ubicación a otra.
Sintaxis
objeto.CopyFile origen, destino [, sobrescribir]
La sintaxis del método CopyFile consta de las siguientes partes:
| Parte | Descripción |
|---|---|
| objeto | Requerido. El objeto siempre es el nombre de un objeto FileSystemObject. |
| origen | Requerido. Especificación del archivo de cadenas de caracteres, que puede incluir caracteres comodín, para uno o más archivos que se copian. |
| destino | Requerido. El destino de la cadena de caracteres donde se van a copiar el archivo o archivos desde el origen. No se permiten los caracteres comodín. |
| sobrescribir | Opcional. Un valor Boolean que indica si los archivos existentes se van a sobrescribir. Si es True, los archivos se sobrescriben; si es False, no se sobrescriben. El valor predeterminado es True. Tenga en cuenta que el método CopyFile fallará si el destino tiene establecido el atributo de sólo lectura, independientemente del valor de sobrescribir. |
Comentarios
Los caracteres comodín sólo se pueden utilizar en el último componente de la ruta del argumento origen. Por ejemplo, puede utilizar:
FileSystemObject.CopyFile "c:\Mis documentos\cartas\*.doc", "c:\carpetatemp\"
Pero no puede utilizar:
FileSystemObject.CopyFile "c:\Mis documentos\*\R1???97.xls", "c:\carpetatemp"
Si el origen contiene caracteres comodín o el destino finaliza con un separador de ruta (\), se supone que destino es una carpeta existente en la que se copiarán los archivos coincidentes. Si no, se supone que el destino es el nombre de un archivo que se va a crear. En cualquier caso, pueden ocurrir tres cosas cuando se copia un archivo individual.
- Si el destino no existe, el origen se copia. Este es el caso normal.
- Si el destino es un archivo existente, se produce un error si sobrescribir es False. Si no, se hace un intento de copiar origen sobre el archivo existente.
- Si el destino es un directorio, se produce un error.
También se produce un error si un origen que utiliza caracteres comodín no coincide con ningún archivo. El método CopyFile se detiene en el primer error que encuentra. No se hace ningún intento de volver atrás o deshacer cualquier cambio realizado antes de que se produzca un error.