Copia uno o más archivos desde una ubicación a otra.

objeto.CopyFile ( origen, destino[, sobreescribir] ) 

Argumentos

objeto

Requerido. objeto siempre es el nombre de un objeto FileSystemObject.

origen

Requerido. Cadena de caracteres de especificación de archivo, que puede incluir caracteres comodín, para uno o más archivos que desea copiar.

destino

Requerido. Cadena de caracteres de destino en la que el archivo o archivos de origen se van a copiar. Los caracteres comodín no están permitidos.

sobreescribir

Opcional. Un valor lógico que indica si los archivos existentes se pueden sobreescribir. Si es igual a true, se sobreescriben los archivos; si es igual a false, no se sobreescriben. El valor predeterminado es true. Observe que CopyFile fallará si destino tiene el atributo de sólo lectura establecido, sea cual sea el valor de sobreescribir.

Comentarios

Los caracteres comodín sólo se pueden utilizar en el componente de la última ruta del argumento origen. Por ejemplo, puede utilizar:

[JScript]
fso = new ActiveXObject("Scripting.FileSystemObject");
fso.CopyFile ("c:\\misdocumentos\\cartas\\*.doc", "c:\\carpetatemporal\\")
[VBScript]
FileSystemObject.CopyFile "c:\misdocumentos\cartas\*.doc", "c:\carpetatemporal\"

Pero no puede utilizar:

[JScript]
fso = new ActiveXObject("Scripting.FileSystemObject");
fso.CopyFile ("c:\\misdocumentos\\*\\R1???97.xls", "c:\\carpetatemporal")
[VBScript]
FileSystemObject.CopyFile "c:\misdocumentos\*\R1???97.xls", "c:\carpetatemporal"

Si origen contiene caracteres comodín o si destino termina con un separador de ruta (\), se asume que destino es una carpeta existente a la que se deben copiar los archivos coincidentes. De lo contrario, se asume que destino es el nombre de un archivo que se debe crear. En cualquier caso, pueden ocurrir tres situaciones al copiar un archivo individual.

• Si destino no existe, origen se copia. Este es el comportamiento habitual.
• Si destino es un archivo existente, se produce un error si sobreescribir es false. De lo contrario, se intenta copiar origen sobre el archivo existente.
• Si 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 intentan deshacer los cambios realizados antes de que se produjera un error.

Consulte también

Método Copy | Método CopyFolder | Método CreateTextFile | Método DeleteFile | Método MoveFile
Se aplica a: Objeto FileSystemObject