CopyFolder, méthodeCopyFolder method

Copie de manière récursive un dossier d’un emplacement vers un autre.Recursively copies a folder from one location to another.

SyntaxeSyntax

objet. CopyFolder source, destination, [ overwrite ]object.CopyFolder source, destination, [ overwrite ]


La syntaxe de la méthode CopyFolder comprend les éléments suivants :The CopyFolder method syntax has these parts:

ÉlémentPart DescriptionDescription
objectobject Obligatoire.Required. Toujours le nom d'un FileSystemObject.Always the name of a FileSystemObject.
sourcesource Obligatoire.Required. 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.Character string folder specification, which can include wildcard characters, for one or more folders to be copied.
destinationdestination Obligatoire.Required. Destination sous forme de chaîne de caractères indiquant où le dossier et les sous-dossiers de la source doivent être copiés.Character string destination where the folder and subfolders from source are to be copied. Les caractères génériques ne sont pas autorisés.Wildcard characters are not allowed.
remplaceroverwrite Facultatif.Optional. Valeur de type Boolean qui indique si les dossiers existants doivent être remplacés.Boolean value that indicates if existing folders are to be overwritten. Si elle a la valeur True, les fichiers sont remplacés ; si elle a la valeur False, ils ne le sont pas.If True, files are overwritten; if False, they are not. La valeur par défaut est True.The default is True.

RemarquesRemarks

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.Wildcard characters can only be used in the last path component of the source argument. Par exemple, vous pouvez utiliser :For example, you can use:

FileSystemObject.CopyFolder "c:\mydocuments\letters\*", "c:\tempfolder\"

Mais vous ne pouvez pas utiliser :But you can't use:

FileSystemObject.CopyFolder "c:\mydocuments\*\*", "c:\tempfolder\"

Si source contient des caractères génériques ou __ s'il se termine par un)séparateur de chemin d'accès (, il est supposé que destination est un dossier existant dans lequel copier les dossiers et sous-dossiers correspondants.If source contains wildcard characters, or destination ends with a path separator (), it is assumed that destination is an existing folder in which to copy matching folders and subfolders. Sinon, on suppose que destination est le nom d’un dossier à créer.Otherwise, destination is assumed to be the name of a folder to create. Dans les deux cas, quatre choses peuvent se produire lors de la copie d'un dossier spécifique:In either case, four things can happen when an individual folder is copied:

  • Si destination n’existe pas, le dossier source et tout son contenu est copié.If destination does not exist, the source folder and all its contents gets copied. Il s’agit du cas le plus courant.This is the usual case.

  • Si destination est un fichier existant, une erreur se produit.If destination is an existing file, an error occurs.

  • Si destination est un répertoire, le système tente de copier le dossier et tout son contenu.If destination is a directory, an attempt is made to copy the folder and all its contents. Si un fichier contenu dans source existe déjà dans destination, une erreur se produit si remplacement a la valeur False.If a file contained in source already exists in destination, an error occurs if overwrite is False. Autrement, le système tente de copier le fichier et de remplacer le fichier existant.Otherwise, it will attempt to copy the file over the existing file.

  • 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.If destination is a read-only directory, an error occurs if an attempt is made to copy an existing read-only file into that directory and overwrite is False.

Une erreur se produit également si une source comportant des caractères génériques ne correspond à aucun dossier.An error also occurs if a source using wildcard characters doesn't match any folders.

La méthode CopyFolder s’arrête lors de la première erreur rencontrée.The CopyFolder method stops on the first error it encounters. Aucune tentative d’annulation des modifications apportées avant l’erreur n’est effectuée.No attempt is made to roll back any changes made before an error occurs.

Voir aussiSee also

Assistance et commentairesSupport and feedback

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ?Have questions or feedback about Office VBA or this 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.