CopyFolder, méthode
Copie de manière récursive un dossier d’un emplacement vers un autre.
Syntaxe
objet . Source copyFolder, destination, [ remplacer ]
La syntaxe de la méthode CopyFolder comprend les éléments suivants :
| Élément | Description |
|---|---|
| object | Obligatoire. Toujours le nom d’un FileSystemObject. |
| source | Obligatoire. Spécification de dossier sous forme de chaîne de caractères, qui peut comprendre des caractères génériques, pour un ou plusieurs dossiers à copier. |
| destination | Obligatoire. Destination sous forme de chaîne de caractères indiquant où le dossier et les sous-dossiers de la source doivent être copiés. Les caractères génériques ne sont pas autorisés. |
| Écraser | Facultatif. Valeur de type Boolean qui indique si les dossiers existants doivent être remplacés. Si elle a la valeur True, les fichiers sont remplacés ; si elle a la valeur False, ils ne le sont pas. La valeur par défaut est True. |
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.CopyFolder "c:\mydocuments\letters\*", "c:\tempfolder\"
Mais vous ne pouvez pas utiliser :
FileSystemObject.CopyFolder "c:\mydocuments\*\*", "c:\tempfolder\"
Si la source contient des caractères génériques ou si la destination se termine par un séparateur de chemin (), il est supposé que destination est un dossier existant dans lequel copier les dossiers et sous-dossiers correspondants. Sinon, on suppose que destination est le nom d’un dossier à créer. Dans les deux cas, quatre choses peuvent se produire lorsqu’un dossier individuel est copié :
Si destination n’existe pas, le dossier source et tout son contenu est copié. Il s’agit du cas le plus courant.
Si destination est un fichier existant, une erreur se produit.
Si destination est un répertoire, le système tente de copier le dossier et tout son contenu. Si un fichier contenu dans source existe déjà dans destination, une erreur se produit si remplacement a la valeur False. Autrement, le système tente de copier le fichier et de remplacer le fichier existant.
Si destination est un répertoire en lecture seule, une erreur se produit si le système tente de copier un fichier en lecture seule existant dans ce répertoire et que overwrite a la valeur False.
Une erreur se produit également si une source comportant des caractères génériques ne correspond à aucun dossier.
La méthode CopyFolder s’arrête lors de la première erreur rencontrée. Aucune tentative d’annulation des modifications apportées avant l’erreur n’est effectuée.
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.