FileSystem.CopyDirectory Méthode

Définition

Copie le contenu d'un répertoire dans un autre répertoire.

Surcharges

CopyDirectory(String, String)

Copie le contenu d'un répertoire dans un autre répertoire.

CopyDirectory(String, String, UIOption)

Copie le contenu d'un répertoire dans un autre répertoire.

CopyDirectory(String, String, Boolean)

Copie le contenu d'un répertoire dans un autre répertoire.

CopyDirectory(String, String, UIOption, UICancelOption)

Copie le contenu d'un répertoire dans un autre répertoire.

CopyDirectory(String, String)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

Copie le contenu d'un répertoire dans un autre répertoire.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);
static member CopyDirectory : string * string -> unit
Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String)

Paramètres

sourceDirectoryName
String

Répertoire à copier.

destinationDirectoryName
String

Emplacement dans lequel le contenu du 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 contenu du répertoire TestDirectory1 dans TestDirectory2.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2")

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 source dans le répertoire cible. 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 un exemple de tâche impliquant la My.Computer.FileSystem.CopyDirectory méthode .

À Consultez
Copier un répertoire Guide pratique pour copier un répertoire vers un autre répertoire en Visual Basic

Voir aussi

S’applique à

CopyDirectory(String, String, UIOption)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

Copie le contenu d'un répertoire dans un autre répertoire.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);
static member CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)

Paramètres

sourceDirectoryName
String

Répertoire à copier.

destinationDirectoryName
String

Emplacement dans lequel le contenu du 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 contenu du répertoire TestDirectory1 dans TestDirectory2, montrant la boîte de dialogue de progression et toute boîte de dialogue d’erreur.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs)

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 source dans le répertoire cible. 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 un exemple de tâche impliquant la My.Computer.FileSystem.CopyDirectory méthode .

À Consultez
Copier un répertoire Guide pratique pour copier un répertoire vers un autre répertoire en Visual Basic

Voir aussi

S’applique à

CopyDirectory(String, String, Boolean)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

Copie le contenu d'un répertoire dans un autre répertoire.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, bool overwrite);
static member CopyDirectory : string * string * bool -> unit
Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)

Paramètres

sourceDirectoryName
String

Répertoire à copier.

destinationDirectoryName
String

Emplacement dans lequel le contenu du 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 contenu du 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 source dans le répertoire cible. 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 un exemple de tâche impliquant la My.Computer.FileSystem.CopyDirectory méthode .

À Consultez
Copier un répertoire Guide pratique pour copier un répertoire vers un autre répertoire en Visual Basic

Voir aussi

S’applique à

CopyDirectory(String, String, UIOption, UICancelOption)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

Copie le contenu d'un répertoire dans un autre répertoire.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
static member CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption, onUserCancel As UICancelOption)

Paramètres

sourceDirectoryName
String

Répertoire à copier.

destinationDirectoryName
String

Emplacement dans lequel le contenu du 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 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 contenu du répertoire TestDirectory1 dans TestDirectory2, affichant la boîte de dialogue de progression et toute boîte de dialogue d’erreur, et ne fait rien si l’utilisateur clique sur Annuler pendant l’opération.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs, UICancelOption.DoNothing)

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 source dans le répertoire cible. 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 un exemple de tâche impliquant la My.Computer.FileSystem.CopyDirectory méthode .

À Consultez
Copier un répertoire Guide pratique pour copier un répertoire vers un autre répertoire en Visual Basic

Voir aussi

S’applique à