FileSystem.CopyDirectory Méthode

Définition

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

Surcharges

Nom Description
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)

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 vers 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 de l’espace blanc ; contient des caractères non valides ; ou il s’agit d’un chemin d’accès d’appareil (commence par \\.\).

destinationDirectoryName ou sourceDirectoryName est Nothing une chaîne vide.

Le répertoire source n’existe pas.

Le chemin d’accès source et le chemin cible sont identiques.

L’opération est cyclique.

Le chemin dépasse la longueur maximale définie par le système.

Un nom de dossier dans le chemin contient un signe deux-points (:) ou est dans un format non valide.

L’utilisateur ne dispose pas des autorisations nécessaires pour afficher le chemin d’accès.

Un fichier de destination existe, mais il n’est pas accessible.

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 d’accès 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 dans 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 dans une exception unique dont Data la propriété contient des entrées sous la forme d’un IDictionary chemin d’accès au fichier ou au répertoire étant la clé et le message d’exception spécifique est contenu dans la valeur correspondante. Permet For…Each d’é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 How to : Copy a Directory to Another Directory in Visual Basic

Voir aussi

S’applique à

CopyDirectory(String, String, UIOption)

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 vers lequel le contenu du répertoire doit être copié.

showUI
UIOption

Indique s’il faut suivre visuellement la progression de l’opération. 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 de l’espace blanc ; contient des caractères non valides ; ou il s’agit d’un chemin d’accès d’appareil (commence par \\.\).

destinationDirectoryName ou sourceDirectoryName est Nothing une chaîne vide.

Le répertoire source n’existe pas.

Le chemin d’accès source et le chemin cible sont identiques.

L’opération est cyclique.

Le chemin dépasse la longueur maximale définie par le système.

Un nom de dossier dans le chemin contient un signe deux-points (:) ou est dans un format non valide.

L’utilisateur ne dispose pas des autorisations nécessaires pour afficher le chemin d’accès.

Un fichier de destination existe, mais il n’est pas accessible.

ShowUI est défini sur 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 TestDirectory1TestDirectory2dans , affichant 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 d’accès 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 dans 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 dans une exception unique dont Data la propriété contient des entrées sous la forme d’un IDictionary chemin d’accès au fichier ou au répertoire étant la clé et le message d’exception spécifique est contenu dans la valeur correspondante. Permet For…Each d’é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 How to : Copy a Directory to Another Directory in Visual Basic

Voir aussi

S’applique à

CopyDirectory(String, String, Boolean)

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 vers 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 de l’espace blanc ; contient des caractères non valides ; ou il s’agit d’un chemin d’accès d’appareil (commence par \\.\).

destinationDirectoryName ou sourceDirectoryName est Nothing une chaîne vide.

Le répertoire source n’existe pas.

Le chemin d’accès source et le chemin cible sont identiques.

L’opération est cyclique.

Le chemin dépasse la longueur maximale définie par le système.

Un nom de dossier dans le chemin contient un signe deux-points (:) ou est dans un format non valide.

L’utilisateur ne dispose pas des autorisations nécessaires pour afficher le chemin d’accès.

Un fichier de destination existe, mais il n’est pas accessible.

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 d’accès 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 dans 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, tel qu’un fichier existant pendant une fusion pendant overwrite la définition False. Lorsque de telles exceptions sont levées, elles sont consolidées dans une exception unique dont Data la propriété contient des entrées sous la forme d’un IDictionary chemin d’accès au fichier ou au répertoire étant la clé et le message d’exception spécifique est contenu dans la valeur correspondante. Permet For…Each d’é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 How to : Copy a Directory to Another Directory in Visual Basic

Voir aussi

S’applique à

CopyDirectory(String, String, UIOption, UICancelOption)

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 vers lequel le contenu du répertoire doit être copié.

showUI
UIOption

Indique s’il faut suivre visuellement la progression de l’opération. 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 de l’espace blanc ; contient des caractères non valides ; ou il s’agit d’un chemin d’accès d’appareil (commence par \\.\).

destinationDirectoryName ou sourceDirectoryName est Nothing une chaîne vide.

Le répertoire source n’existe pas.

Le chemin d’accès source et le chemin cible sont identiques.

L’opération est cyclique.

Le chemin dépasse la longueur maximale définie par le système.

Un nom de dossier dans le chemin contient un signe deux-points (:) ou est dans un format non valide.

L’utilisateur ne dispose pas des autorisations nécessaires pour afficher le chemin d’accès.

Un fichier de destination existe, mais il n’est pas accessible.

ShowUI est défini sur 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 TestDirectory1TestDirectory2dans , 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 d’accès 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 dans 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 dans une exception unique dont Data la propriété contient des entrées sous la forme d’un IDictionary chemin d’accès au fichier ou au répertoire étant la clé et le message d’exception spécifique est contenu dans la valeur correspondante. Permet For…Each d’é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 How to : Copy a Directory to Another Directory in Visual Basic

Voir aussi

S’applique à