CopyFile, méthode

  • Article

Copie un fichier ou plus d’un emplacement vers un autre.

Syntaxe

objet . Source copyFile, destination, [ remplacer ]

La syntaxe de la méthode CopyFile comprend les éléments suivants :

Élément Description
object Obligatoire. L’objet est toujours le nom d’un FileSystemObject.
source Obligatoire. Spécification du fichier chaîne de caractères, qui peut inclure des caractères génériques, pour un ou plusieurs fichiers à copier.
destination Obligatoire. Destination de la chaîne de caractères où le ou les fichiers de source doivent être copiés. Les caractères génériques ne sont pas autorisés.
Écraser Facultatif. Valeur booléenne qui indique si les fichiers existants doivent être remplacés. Si la valeur est True, les fichiers sont remplacés ; si la valeur est False, ils ne sont pas remplacés. La valeur par défaut est True. Notez que CopyFile échoue si l'attribut lecture seule est défini pour l'argument destination, quelle que soit la valeur de overwrite.

Remarques

Les caractères génériques peuvent être utilisés uniquement dans le dernier élément de chemin d’accès de l’argument source. Par exemple, vous pouvez utiliser :

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

Mais vous ne pouvez pas utiliser :

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

Si la source contient des caractères génériques ou si la destination se termine par un séparateur de chemin d’accès (****), il est supposé que la destination est un dossier existant dans lequel copier les fichiers correspondants. Sinon, l'argument destination est par défaut le nom d'un fichier à créer. Dans les deux cas, trois choses peuvent se produire lorsqu’un fichier individuel est copié :

  • Si destination n'existe pas, source est copié. Il s'agit du cas le plus courant.

  • Si destination est un fichier existant, une erreur se produit si overwrite a la valeur False. Sinon, une tentative de copie de source est effectuée sur le fichier existant.

  • Si destination est un répertoire, une erreur se produit.

Une erreur se produit également si un argument source utilisant des caractères génériques ne correspond à aucun fichier. La méthode CopyFile s'arrête à la première erreur rencontrée. Il n'y a aucune tentative de restauration ou d'annulation des modifications effectuées avant qu'une erreur ne se produise.

Les fichiers copiés dans un nouveau chemin d’accès de destination conservent le même nom de fichier. Pour renommer le fichier copié, incluez simplement le nouveau nom de fichier dans le chemin d’accès de destination. Par exemple, cela copiera le fichier vers un nouvel emplacement et le fichier dans le nouvel emplacement aura un nom différent :

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

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.