CopyFolder, méthode

Copie récursivement un dossier d'un emplacement vers un autre.

object.CopyFolder source, destination[, overwrite]

Arguments

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 :

FileSystemObject.CopyFolder "c:\Documents\lettres\*", "c:\tempfolder\"

Vous ne pouvez pas utiliser :

FileSystemObject.CopyFolder "c:\Documents\*\*", "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.

• 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.

Une erreur se produit aussi si une source contenant des caractères génériques ne correspond à aucun dossier.

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.

Voir aussi

CopyFile, méthode | Copy, méthode | CreateFolder, méthode | DeleteFolder, méthode | MoveFolder, méthode

Application: FileSystemObject, objet