FileSystemProxy.CopyFile Méthode

Définition

Espace de noms:

Microsoft.VisualBasic.MyServices

Assembly:

Microsoft.VisualBasic.Forms.dll

Copie un fichier vers un nouvel emplacement.

Surcharges

CopyFile(String, String)	Copie un fichier vers un nouvel emplacement.
CopyFile(String, String, UIOption)	Copie un fichier vers un nouvel emplacement.
CopyFile(String, String, Boolean)	Copie un fichier vers un nouvel emplacement.
CopyFile(String, String, UIOption, UICancelOption)	Copie un fichier vers un nouvel emplacement.

CopyFile(String, String)

Copie un fichier vers un nouvel emplacement.

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public void CopyFile (string sourceFileName, string destinationFileName);

member this.CopyFile : string * string -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String)

Paramètres

sourceFileName

String

Fichier à copier.

destinationFileName

String

Emplacement vers lequel le fichier doit être copié.

Exceptions

ArgumentException

destinationFileName contient des informations de chemin d’accès.

ArgumentNullException

destinationFileName ou sourceFileName est Nothing ou représente une chaîne vide.

FileNotFoundException

Le fichier source n'est pas valide ou n'existe pas.

IOException

Un fichier du répertoire cible portant le même nom est en cours d'utilisation.

NotSupportedException

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.

PathTooLongException

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

UnauthorizedAccessException

L'utilisateur n'a pas l'autorisation requise.

SecurityException

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.

Exemples

Cet exemple copie le fichier Test.txt dans le répertoire TestFiles2 sans remplacer les fichiers existants.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Remplacez les chemins d’accès aux fichiers par les chemins que vous souhaitez utiliser dans votre code.

Cet exemple copie le fichier Test.txt dans le répertoire TestFiles2 et le NewFile.txtrenomme .

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Remplacez les chemins d’accès aux fichiers par les chemins que vous souhaitez utiliser dans votre code.

Remarques

CopyFilene conserve pas les entrées ACL (entrées Access Control). Le fichier nouvellement créé hérite des ACL par défaut du répertoire dans lequel il est créé.

Le tableau suivant répertorie des exemples de tâches impliquant la My.Computer.FileSystem.CopyFile méthode .

À	Consultez
Copiez un fichier dans le même répertoire.	Procédure : créer une copie d’un fichier dans le même répertoire
Copiez un fichier dans un autre répertoire.	Procédure : créer une copie d’un fichier dans un autre répertoire

Voir aussi

• UICancelOption
• Objets (Visual Basic)
• Guide pratique pour copier des fichiers avec un modèle spécifique dans un répertoire en Visual Basic
• Guide pratique pour créer une copie d'un fichier dans le même répertoire en Visual Basic
• Guide pratique pour copier un répertoire vers un autre répertoire en Visual Basic
• Guide pratique pour renommer un fichier en Visual Basic

CopyFile(String, String, UIOption)

Copie un fichier vers un nouvel emplacement.

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public void CopyFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);

member this.CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

Paramètres

sourceFileName

String

Fichier à copier.

destinationFileName

String

Emplacement vers lequel le fichier 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

ArgumentException

destinationFileName contient des informations de chemin d’accès.

ArgumentNullException

destinationFileName ou sourceFileName est Nothing ou représente une chaîne vide.

FileNotFoundException

Le fichier source n'est pas valide ou n'existe pas.

IOException

Le fichier de destination existe et overwrite a la valeur False ().

NotSupportedException

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.

PathTooLongException

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

UnauthorizedAccessException

L'utilisateur n'a pas l'autorisation requise.

SecurityException

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.

Exemples

Cet exemple copie le fichier Test.txt dans le répertoire TestFiles2 sans remplacer les fichiers existants.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Remplacez les chemins d’accès aux fichiers par les chemins que vous souhaitez utiliser dans votre code.

Cet exemple copie le fichier Test.txt dans le répertoire TestFiles2 et le NewFile.txtrenomme .

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Remplacez les chemins d’accès aux fichiers par les chemins que vous souhaitez utiliser dans votre code.

Remarques

CopyFilene conserve pas les entrées ACL (entrées Access Control). Le fichier nouvellement créé hérite des ACL par défaut du répertoire dans lequel il est créé.

Le tableau suivant répertorie des exemples de tâches impliquant la My.Computer.FileSystem.CopyFile méthode .

À	Consultez
Copiez un fichier dans le même répertoire.	Procédure : créer une copie d’un fichier dans le même répertoire
Copiez un fichier dans un autre répertoire.	Procédure : créer une copie d’un fichier dans un autre répertoire

Voir aussi

• UICancelOption
• Objets (Visual Basic)
• Guide pratique pour copier des fichiers avec un modèle spécifique dans un répertoire en Visual Basic
• Guide pratique pour créer une copie d'un fichier dans le même répertoire en Visual Basic
• Guide pratique pour copier un répertoire vers un autre répertoire en Visual Basic
• Guide pratique pour renommer un fichier en Visual Basic

CopyFile(String, String, Boolean)

Copie un fichier vers un nouvel emplacement.

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);

public void CopyFile (string sourceFileName, string destinationFileName, bool overwrite);

member this.CopyFile : string * string * bool -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

Paramètres

sourceFileName

String

Fichier à copier.

destinationFileName

String

Emplacement vers lequel le fichier doit être copié.

overwrite

Boolean

True si les fichiers existants doivent être remplacés ; sinon, False. La valeur par défaut est False.

Exceptions

ArgumentException

destinationFileName contient des informations de chemin d’accès.

ArgumentNullException

destinationFileName ou sourceFileName est Nothing ou représente une chaîne vide.

FileNotFoundException

Le fichier source n'est pas valide ou n'existe pas.

IOException

Le fichier de destination existe et overwrite a la valeur False ().

NotSupportedException

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.

PathTooLongException

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

UnauthorizedAccessException

L'utilisateur n'a pas l'autorisation requise.

SecurityException

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.

Exemples

Cet exemple copie le fichier Test.txt dans le répertoire TestFiles2 sans remplacer les fichiers existants.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Remplacez les chemins d’accès aux fichiers par les chemins que vous souhaitez utiliser dans votre code.

Cet exemple copie le fichier Test.txt dans le répertoire TestFiles2 et le NewFile.txtrenomme .

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Remplacez les chemins d’accès aux fichiers par les chemins que vous souhaitez utiliser dans votre code.

Remarques

CopyFilene conserve pas les entrées ACL (entrées Access Control). Le fichier nouvellement créé hérite des ACL par défaut du répertoire dans lequel il est créé.

Le tableau suivant répertorie des exemples de tâches impliquant la My.Computer.FileSystem.CopyFile méthode .

À	Consultez
Copiez un fichier dans le même répertoire.	Procédure : créer une copie d’un fichier dans le même répertoire
Copiez un fichier dans un autre répertoire.	Procédure : créer une copie d’un fichier dans un autre répertoire

Voir aussi

• UICancelOption
• Objets (Visual Basic)
• Guide pratique pour copier des fichiers avec un modèle spécifique dans un répertoire en Visual Basic
• Guide pratique pour créer une copie d'un fichier dans le même répertoire en Visual Basic
• Guide pratique pour copier un répertoire vers un autre répertoire en Visual Basic
• Guide pratique pour renommer un fichier en Visual Basic

CopyFile(String, String, UIOption, UICancelOption)

Copie un fichier vers un nouvel emplacement.

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void CopyFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

Paramètres

sourceFileName

String

Fichier à copier.

destinationFileName

String

Emplacement vers lequel le fichier 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

ArgumentException

destinationFileName contient des informations de chemin d’accès.

ArgumentNullException

destinationFileName ou sourceFileName est Nothing ou représente une chaîne vide.

FileNotFoundException

Le fichier source n'est pas valide ou n'existe pas.

IOException

Le fichier de destination existe et overwrite a la valeur False ().

NotSupportedException

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.

PathTooLongException

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

UnauthorizedAccessException

L'utilisateur n'a pas l'autorisation requise.

SecurityException

L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès.

OperationCanceledException

UICancelOption a la valeur ThrowException et l'utilisateur a annulé l'opération ou une erreur d'E/S non spécifiée s'est produit.

Exemples

Cet exemple copie le fichier Test.txt dans le répertoire TestFiles2 sans remplacer les fichiers existants.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Remplacez les chemins d’accès aux fichiers par les chemins que vous souhaitez utiliser dans votre code.

Cet exemple copie le fichier Test.txt dans le répertoire TestFiles2 et le NewFile.txtrenomme .

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Remplacez les chemins d’accès aux fichiers par les chemins que vous souhaitez utiliser dans votre code.

Remarques

CopyFilene conserve pas les entrées ACL (entrées Access Control). Le fichier nouvellement créé hérite des ACL par défaut du répertoire dans lequel il est créé.

Le tableau suivant répertorie des exemples de tâches impliquant la My.Computer.FileSystem.CopyFile méthode .

À	Consultez
Copiez un fichier dans le même répertoire.	Procédure : créer une copie d’un fichier dans le même répertoire
Copiez un fichier dans un autre répertoire.	Procédure : créer une copie d’un fichier dans un autre répertoire

Voir aussi

• UICancelOption
• Objets (Visual Basic)
• Guide pratique pour copier des fichiers avec un modèle spécifique dans un répertoire en Visual Basic
• Guide pratique pour créer une copie d'un fichier dans le même répertoire en Visual Basic
• Guide pratique pour copier un répertoire vers un autre répertoire en Visual Basic
• Guide pratique pour renommer un fichier en Visual Basic