| Microsoft® Visual Basic® Scripting Edition CopyFolder, méthode |
Référence de la bibliothèque d'exécution Scripting Version 3 |
Description
Copie récursivement un dossier d'un emplacement vers un autre.
Syntaxe
object.CopyFolder source, destination[, overwrite]La syntaxe de la méthode CopyFolder comprend les éléments suivants :
Élément Description object Correspond toujours au nom d'un objet FileSystemObject. source Chaîne de spécification de dossiers pouvant contenir des caractères génériques afin de copier un ou plusieurs dossiers. destination Chaîne de spécification de la destination de la copie du ou des dossiers et sous-dossiers issus de source. Les caractères génériques ne sont pas autorisés. overwrite Facultatif. Valeur de type Boolean indiquant si les dossiers existants sont remplacés. Si l'argument a la valeur True, les fichiers sont remplacés ; s'il prend la valeur False, ils ne le sont pas. La valeur par défaut est True.
Notes
Les caractères génériques sont autorisés uniquement pour le dernier composant de l'argument source. Par exemple, vous pouvez utiliser :Vous ne pouvez pas utiliser :FileSystemObject.CopyFolder "c:\Documents\lettres\*", "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 quatre possibilités.FileSystemObject.CopyFolder "c:\Documents\*\*", "c:\tempfolder\"Une erreur se produit aussi si une source contenant des caractères génériques ne correspond à aucun dossier.
- 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 destination est un dossier, l'opération tente de copier le dossier et son contenu. Si un fichier contenu dans source existe déjà dans destination, une erreur se produit si overwrite est False. Sinon, la copie tente de remplacer le fichier existant.
- Si destination est un dossier en lecture seule, une erreur se produit si l'opération tente de copier un fichier existant en lecture seule dans ce dossier alors que overwrite vaut False.
La méthode CopyFolder 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.