CopyFile, méthode

Copie un ou plusieurs fichiers d'un emplacement vers un autre.

object.CopyFile source, destination[, overwrite]

Arguments

object

L'argument object représente toujours un objet FileSystemObject.

source

Chaîne de spécification de fichiers pouvant contenir des caractères génériques afin de copier un ou plusieurs fichiers.

destination

Chaîne de spécification de la destination de la copie du ou des fichiers issus de source. Les caractères génériques ne sont pas autorisés.

overwrite

Facultatif. Valeur de type Boolean indiquant si les fichiers existants sont remplacés. Si l'argument vaut True, les fichiers sont remplacés ; s'il vaut False, ils ne le sont pas. La valeur par défaut est True. Notez que CopyFile échoue si destination est en lecture seule, quelle que soit la valeur de overwrite.

Notes

Les caractères génériques sont autorisés uniquement pour le dernier composant de l'argument source argument. Par exemple, vous pouvez utiliser :

FileSystemObject.CopyFile "c:\Documents\lettres\*.doc", "c:\tempfolder\"

Vous ne pouvez pas utiliser :

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

Si l'argument source contient des caractères génériques ou si destination se termine par un séparateur de chemin (\), destination est considéré comme un dossier existant vers lequel s'effectue la copie des dossiers et sous-dossiers désignés. Sinon, destination est considéré comme le nom du dossier à créer. Dans les deux cas, la copie d'un dossier individuel présente trois possibilités.

• Si destination n'existe pas, le dossier source et son contenu sont copiés. C'est le cas le plus courant.
• Si destination est un fichier existant, une erreur se produit si overwrite est False. Sinon, la copie tente de remplacer le fichier source existant.
• Si destination est un dossier existant, une erreur se produit.

Une erreur se produit aussi si une source contenant des caractères génériques ne correspond à aucun dossier. La méthode CopyFile s'arrête sur la première erreur rencontrée. Aucune tentative n'est effectuée pour annuler les modifications précédant l'erreur.

Voir aussi

Copy, méthode | CopyFolder, méthode | CreateTextFile, méthode | DeleteFile, méthode | MoveFile, méthode

Application: FileSystemObject, objet