FileSystemProxy.CopyDirectory Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Copie un répertoire dans un autre répertoire.
Surcharges
| CopyDirectory(String, String) |
Copie un répertoire dans un autre répertoire. |
| CopyDirectory(String, String, UIOption) |
Copie un répertoire dans un autre répertoire. |
| CopyDirectory(String, String, Boolean) |
Copie un répertoire dans un autre répertoire. |
| CopyDirectory(String, String, UIOption, UICancelOption) |
Copie un répertoire dans un autre répertoire. |
CopyDirectory(String, String)
Copie un répertoire dans un autre répertoire.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);member this.CopyDirectory : string * string -> unitPublic Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String)Paramètres
- sourceDirectoryName
- String
Répertoire à copier.
- destinationDirectoryName
- String
Emplacement vers lequel le répertoire doit être copié.
Exceptions
Le chemin d’accès n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur nulle ; il contient uniquement des espaces blancs ; elle contient des caractères non valides ; ou il s’agit d’un chemin d’appareil (commence par \\.\).
destinationDirectoryName ou sourceDirectoryName est Nothing ou représente une chaîne vide.
Le répertoire source n'existe pas.
Le chemin source et le chemin cible sont identiques.
L'opération est cyclique.
Le chemin d'accès dépasse la longueur maximale définie par le système.
Un nom de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.
L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.
Un fichier de destination existe mais est inaccessible.
Exemples
L’exemple suivant copie le répertoire TestDirectory1 dans TestDirectory2, en remplaçant les fichiers existants.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Remplacez et C:\TestDirectory2 par C:\TestDirectory1 le chemin et le nom du répertoire que vous souhaitez copier et l’emplacement vers lequel vous souhaitez le copier.
Remarques
Cette méthode copie le contenu du répertoire, ainsi que le répertoire lui-même. Si le répertoire cible n’existe pas, il est créé. Si un répertoire portant le même nom existe à l’emplacement cible, le contenu des deux répertoires est fusionné. Vous pouvez spécifier un nouveau nom pour le répertoire pendant l’opération.
Lors de la copie de fichiers dans un répertoire, des exceptions peuvent être levées en raison d’un fichier spécifique. Lorsque de telles exceptions sont levées, elles sont consolidées en une seule exception dont Data la propriété contient des entrées sous la forme d’un IDictionary dans lequel le chemin d’accès au fichier ou au répertoire est la clé et le message d’exception spécifique est contenu dans la valeur correspondante. Utilisez For…Each pour énumérer les entrées.
Le tableau suivant répertorie des exemples de tâches impliquant la My.Computer.FileSystem.CopyDirectory méthode .
| À | Consultez |
|---|---|
| Copier un répertoire | Procédure : copier un répertoire vers un autre répertoire |
Voir aussi
- UICancelOption
- Objets (Visual Basic)
- Guide pratique pour obtenir la collection de fichiers dans un répertoire en Visual Basic
- Comment : analyser des chemins d'accès dans Visual Basic
S’applique à
CopyDirectory(String, String, UIOption)
Copie un répertoire dans un autre répertoire.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);member this.CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)Paramètres
- sourceDirectoryName
- String
Répertoire à copier.
- destinationDirectoryName
- String
Emplacement vers lequel le répertoire doit être copié.
- showUI
- UIOption
Indique si un suivi visuel de l'avancement de l'opération est nécessaire. La valeur par défaut est UIOption.OnlyErrorDialogs.
Exceptions
Le chemin d’accès n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur nulle ; il contient uniquement des espaces blancs ; elle contient des caractères non valides ; ou il s’agit d’un chemin d’appareil (commence par \\.\).
destinationDirectoryName ou sourceDirectoryName est Nothing ou représente une chaîne vide.
Le répertoire source n'existe pas.
Le chemin source et le chemin cible sont identiques.
L'opération est cyclique.
Le chemin d'accès dépasse la longueur maximale définie par le système.
Un nom de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.
L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.
Un fichier de destination existe mais est inaccessible.
ShowUI a la valeur UIOption.AllDialogs et l'utilisateur annule l'opération, ou un ou plusieurs fichiers du répertoire ne peuvent pas être copiés.
Exemples
L’exemple suivant copie le répertoire TestDirectory1 dans TestDirectory2, en remplaçant les fichiers existants.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Remplacez et C:\TestDirectory2 par C:\TestDirectory1 le chemin et le nom du répertoire que vous souhaitez copier et l’emplacement vers lequel vous souhaitez le copier.
Remarques
Cette méthode copie le contenu du répertoire, ainsi que le répertoire lui-même. Si le répertoire cible n’existe pas, il est créé. Si un répertoire portant le même nom existe à l’emplacement cible, le contenu des deux répertoires est fusionné. Vous pouvez spécifier un nouveau nom pour le répertoire pendant l’opération.
Lors de la copie de fichiers dans un répertoire, des exceptions peuvent être levées en raison d’un fichier spécifique. Lorsque de telles exceptions sont levées, elles sont consolidées en une seule exception dont Data la propriété contient des entrées sous la forme d’un IDictionary dans lequel le chemin d’accès au fichier ou au répertoire est la clé et le message d’exception spécifique est contenu dans la valeur correspondante. Utilisez For…Each pour énumérer les entrées.
Le tableau suivant répertorie des exemples de tâches impliquant la My.Computer.FileSystem.CopyDirectory méthode .
| À | Consultez |
|---|---|
| Copier un répertoire | Procédure : copier un répertoire vers un autre répertoire |
Voir aussi
- UICancelOption
- Objets (Visual Basic)
- Guide pratique pour obtenir la collection de fichiers dans un répertoire en Visual Basic
- Comment : analyser des chemins d'accès dans Visual Basic
S’applique à
CopyDirectory(String, String, Boolean)
Copie un répertoire dans un autre répertoire.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, bool overwrite);member this.CopyDirectory : string * string * bool -> unitPublic Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)Paramètres
- sourceDirectoryName
- String
Répertoire à copier.
- destinationDirectoryName
- String
Emplacement vers lequel le répertoire doit être copié.
- overwrite
- Boolean
True pour remplacer les fichiers existants ; sinon, False. La valeur par défaut est False.
Exceptions
Le chemin d’accès n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur nulle ; il contient uniquement des espaces blancs ; elle contient des caractères non valides ; ou il s’agit d’un chemin d’appareil (commence par \\.\).
destinationDirectoryName ou sourceDirectoryName est Nothing ou représente une chaîne vide.
Le répertoire source n'existe pas.
Le chemin source et le chemin cible sont identiques.
L'opération est cyclique.
Le chemin d'accès dépasse la longueur maximale définie par le système.
Un nom de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.
L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.
Un fichier de destination existe mais est inaccessible.
Exemples
L’exemple suivant copie le répertoire TestDirectory1 dans TestDirectory2, en remplaçant les fichiers existants.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Remplacez et C:\TestDirectory2 par C:\TestDirectory1 le chemin et le nom du répertoire que vous souhaitez copier et l’emplacement vers lequel vous souhaitez le copier.
Remarques
Cette méthode copie le contenu du répertoire, ainsi que le répertoire lui-même. Si le répertoire cible n’existe pas, il est créé. Si un répertoire portant le même nom existe à l’emplacement cible, le contenu des deux répertoires est fusionné. Vous pouvez spécifier un nouveau nom pour le répertoire pendant l’opération.
Lors de la copie de fichiers dans un répertoire, des exceptions peuvent être levées en raison d’un fichier spécifique, tel qu’un fichier existant pendant une fusion alors que overwrite est défini sur False. Lorsque de telles exceptions sont levées, elles sont consolidées en une seule exception dont Data la propriété contient des entrées sous la forme d’un IDictionary dans lequel le chemin d’accès au fichier ou au répertoire est la clé et le message d’exception spécifique est contenu dans la valeur correspondante. Utilisez For…Each pour énumérer les entrées.
Le tableau suivant répertorie des exemples de tâches impliquant la My.Computer.FileSystem.CopyDirectory méthode .
| À | Consultez |
|---|---|
| Copier un répertoire | Procédure : copier un répertoire vers un autre répertoire |
Voir aussi
- UICancelOption
- Objets (Visual Basic)
- Guide pratique pour obtenir la collection de fichiers dans un répertoire en Visual Basic
- Comment : analyser des chemins d'accès dans Visual Basic
S’applique à
CopyDirectory(String, String, UIOption, UICancelOption)
Copie un répertoire dans un autre répertoire.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption, onUserCancel As UICancelOption)Paramètres
- sourceDirectoryName
- String
Répertoire à copier.
- destinationDirectoryName
- String
Emplacement vers lequel le répertoire doit être copié.
- showUI
- UIOption
Indique si un suivi visuel de l'avancement de l'opération est nécessaire. La valeur par défaut est UIOption.OnlyErrorDialogs.
- onUserCancel
- UICancelOption
Spécifie ce qui doit être fait si l’utilisateur clique sur Annuler pendant l’opération. La valeur par défaut est ThrowException.
Exceptions
Le chemin d’accès n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur nulle ; il ne contient que des espaces blancs ; il contient des caractères non valides ; ou il s’agit d’un chemin d’appareil (commence par \\.\).
destinationDirectoryName ou sourceDirectoryName est Nothing ou représente une chaîne vide.
Le répertoire source n'existe pas.
Le chemin source et le chemin cible sont identiques.
L'opération est cyclique.
Le chemin d'accès dépasse la longueur maximale définie par le système.
Un nom de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.
L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.
Un fichier de destination existe mais est inaccessible.
ShowUI a la valeur UIOption.AllDialogs et l'utilisateur annule l'opération, ou un ou plusieurs fichiers du répertoire ne peuvent pas être copiés.
Exemples
L’exemple suivant copie le répertoire TestDirectory1 dans TestDirectory2, en remplaçant les fichiers existants.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Remplacez et C:\TestDirectory2 par C:\TestDirectory1 le chemin d’accès et le nom du répertoire que vous souhaitez copier et l’emplacement dans lequel vous souhaitez le copier.
Remarques
Cette méthode copie le contenu du répertoire, ainsi que le répertoire lui-même. Si le répertoire cible n’existe pas, il est créé. Si un répertoire portant le même nom existe à l’emplacement cible, le contenu des deux répertoires est fusionné. Vous pouvez spécifier un nouveau nom pour le répertoire pendant l’opération.
Lors de la copie de fichiers dans un répertoire, des exceptions peuvent être levées qui sont provoquées par un fichier spécifique. Lorsque de telles exceptions sont levées, elles sont consolidées en une seule exception dont Data la propriété contient des entrées sous la forme d’un IDictionary dans lequel le chemin d’accès du fichier ou du répertoire est la clé et le message d’exception spécifique est contenu dans la valeur correspondante. Utilisez For…Each pour énumérer les entrées.
Le tableau suivant répertorie des exemples de tâches impliquant la My.Computer.FileSystem.CopyDirectory méthode.
| À | Consultez |
|---|---|
| Copier un répertoire | Procédure : copier un répertoire vers un autre répertoire |
Voir aussi
- UICancelOption
- Objets (Visual Basic)
- Guide pratique pour obtenir la collection de fichiers dans un répertoire en Visual Basic
- Comment : analyser des chemins d'accès dans Visual Basic
