CopyFile (método)

Copia uno o varios archivos desde una ubicación a otra.

Sintaxis

objeto . CopyFilesource, destination, [ overwrite ]

La sintaxis del método CopyFile consta de las siguientes partes:

Parte	Descripción
object	Obligatorio. El objeto siempre es el nombre de un Objeto FileSystemObject.
source	Obligatorio. Especificación del archivo de cadena de caracteres, que puede incluir caracteres comodín, para uno o varios archivos que se van a copiar.
destination	Obligatorio. Cadena de caracteres de destino donde se copiará el archivo o los archivos de origen. No se pueden usar caracteres comodín.
Sobrescribir	Opcional. Valor booleano que indica si se van a sobrescribir los archivos existentes. Si es True, los archivos se sobrescriben; si es False, no lo son. El valor predeterminado es True. Tenga en cuenta que CopyFile producirá un error si el destino tiene el atributo de solo lectura establecido, independientemente del valor de overwrite.

Comentarios

Los caracteres comodín solo se pueden usar en el componente de la ruta de acceso del argumento source. Por ejemplo, puede usar:

FileSystemObject.CopyFile "c:\mydocuments\letters\*.doc", "c:\tempfolder\"

Pero no puede usar:

FileSystemObject.CopyFile "c:\mydocuments\*\R1???97.xls", "c:\tempfolder"

Si el origen contiene caracteres comodín, o el destino termina con un separador de ruta de acceso (****), se supone que el destino es una carpeta existente en la que copiar los archivos coincidentes. De lo contrario, se asume que el destino es el nombre del archivo de destino 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 habitual.

• Si el destino es un archivo existente, se producirá un error si overwrite tiene el valor False. De lo contrario, se tratará de copiar el 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 usa caracteres comodín no coincide con ningún archivo. El método CopyFile se detiene en el primer error que encuentra. No se intenta revertir ni deshacer los cambios realizados antes de que se produzca un error.

Los archivos copiados en una nueva ruta de acceso de destino conservarán el mismo nombre de archivo. Para cambiar el nombre del archivo copiado, basta con incluir el nuevo nombre de archivo en la ruta de acceso de destino. Por ejemplo, se copiará el archivo en una nueva ubicación y el archivo de la nueva ubicación tendrá un nombre diferente:

FileSystemObject.CopyFile "c:\mydocuments\letters\sample.doc", "c:\tempfolder\sample_new.doc"

Vea también

• Objetos (Visual Basic para Aplicaciones)

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.