FileSystem.MoveFile Méthode

Définition

Espace de noms:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Déplace un fichier vers un nouvel emplacement.

Surcharges

MoveFile(String, String)	Déplace un fichier vers un nouvel emplacement.
MoveFile(String, String, UIOption)	Déplace un fichier vers un nouvel emplacement.
MoveFile(String, String, Boolean)	Déplace un fichier vers un nouvel emplacement.
MoveFile(String, String, UIOption, UICancelOption)	Déplace un fichier vers un nouvel emplacement.

MoveFile(String, String)

Source:

FileSystem.vb

Déplace un fichier vers un nouvel emplacement.

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

public static void MoveFile (string sourceFileName, string destinationFileName);

static member MoveFile : string * string -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)

Paramètres

sourceFileName

String

Chemin d'accès au fichier à déplacer.

destinationFileName

String

Chemin d'accès au répertoire dans lequel le fichier doit être déplacé.

Exceptions

ArgumentException

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 \\.\) ; il se termine par une barre oblique de fin.

ArgumentNullException

destinationFileName est soit Nothing soit une chaîne vide.

FileNotFoundException

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

IOException

Le fichier est utilisé par un autre processus ou une erreur d'E/S se produit.

PathTooLongException

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

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.

SecurityException

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

Exemples

Dans cet exemple, le fichier nommé Test.txt est déplacé de TestDir1 vers TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

Cet exemple montre comment déplacer le fichier Test.txt de TestDir1 à TestDir2 et le Test2.txtrenommer .

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Remarques

Si la structure cible n’existe pas, elle est créée.

La MoveFile méthode conserve les AE (Access Control Entrées) uniquement lors du déplacement du fichier dans le même volume. Cela inclut les ACÉ hérités, qui deviennent des ACÉ directs lorsqu’ils sont déplacés (les ACÉ directs sont prioritaires sur les ACÉ hérités). Si un fichier est déplacé d’un volume à l’autre, les AE ne sont pas copiés.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.FileSystem.MoveFile méthode .

À	Consultez
Déplacer un fichier	Guide pratique pour déplacer un fichier en Visual Basic

MoveFile(String, String, UIOption)

Source:

FileSystem.vb

Déplace un fichier vers un nouvel emplacement.

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

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

static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

Paramètres

sourceFileName

String

Chemin d'accès au fichier à déplacer.

destinationFileName

String

Chemin d'accès au répertoire dans lequel le fichier doit être déplacé.

showUI

UIOption

Spécifie s'il faut effectuer un suivi visuel de l'avancement de l'opération. La valeur par défaut est UIOption.OnlyErrorDialogs.

Exceptions

ArgumentException

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 \\.\) ; il se termine par une barre oblique de fin.

ArgumentNullException

destinationFileName est soit Nothing soit une chaîne vide.

FileNotFoundException

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

IOException

Le fichier est utilisé par un autre processus ou une erreur d'E/S se produit.

PathTooLongException

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

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.

SecurityException

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

Exemples

Dans cet exemple, le fichier nommé Test.txt est déplacé de TestDir1 vers TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

Cet exemple montre comment déplacer le fichier Test.txt de TestDir1 à TestDir2 et le Test2.txtrenommer .

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Remarques

Si la structure cible n’existe pas, elle est créée.

La MoveFile méthode conserve les AE (Access Control Entrées) uniquement lors du déplacement du fichier dans le même volume. Cela inclut les ACÉ hérités, qui deviennent des ACÉ directs lorsqu’ils sont déplacés (les ACÉ directs sont prioritaires sur les ACÉ hérités). Si un fichier est déplacé d’un volume à l’autre, les AE ne sont pas copiés.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.FileSystem.MoveFile méthode .

À	Consultez
Déplacer un fichier	Guide pratique pour déplacer un fichier en Visual Basic

Voir aussi

• UIOption

MoveFile(String, String, Boolean)

Source:

FileSystem.vb

Déplace un fichier vers un nouvel emplacement.

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

public static void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);

static member MoveFile : string * string * bool -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

Paramètres

sourceFileName

String

Chemin d'accès au fichier à déplacer.

destinationFileName

String

Chemin d'accès au répertoire dans lequel le fichier doit être déplacé.

overwrite

Boolean

True pour remplacer les fichiers existants ; sinon, False. La valeur par défaut est False.

Exceptions

ArgumentException

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 \\.\) ; il se termine par une barre oblique de fin.

ArgumentNullException

destinationFileName est soit Nothing soit une chaîne vide.

FileNotFoundException

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

IOException

Le fichier est utilisé par un autre processus ou une erreur d'E/S se produit.

PathTooLongException

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

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.

SecurityException

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

Exemples

Dans cet exemple, le fichier nommé Test.txt est déplacé de TestDir1 vers TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

Cet exemple montre comment déplacer le fichier Test.txt de TestDir1 à TestDir2 et le Test2.txtrenommer .

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Remarques

Si la structure cible n’existe pas, elle est créée.

La MoveFile méthode conserve les AE (Access Control Entrées) uniquement lors du déplacement du fichier dans le même volume. Cela inclut les ACÉ hérités, qui deviennent des ACÉ directs lorsqu’ils sont déplacés (les ACÉ directs sont prioritaires sur les ACÉ hérités). Si un fichier est déplacé d’un volume à l’autre, les AE ne sont pas copiés.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.FileSystem.MoveFile méthode .

À	Consultez
Déplacer un fichier	Guide pratique pour déplacer un fichier en Visual Basic

MoveFile(String, String, UIOption, UICancelOption)

Source:

FileSystem.vb

Déplace un fichier vers un nouvel emplacement.

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

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

static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

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

Paramètres

sourceFileName

String

Chemin d'accès au fichier à déplacer.

destinationFileName

String

Chemin d'accès au répertoire dans lequel le fichier doit être déplacé.

showUI

UIOption

Spécifie s'il faut effectuer un suivi visuel de l'avancement de l'opération. La valeur par défaut est UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Spécifie si oui ou non une exception est levée lorsque l'utilisateur annule l'opération. La valeur par défaut est UICancelOption.ThrowException.

Exceptions

ArgumentException

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 \\.\) ; il se termine par une barre oblique de fin.

ArgumentNullException

destinationFileName est soit Nothing soit une chaîne vide.

FileNotFoundException

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

IOException

Le fichier est utilisé par un autre processus ou une erreur d'E/S se produit.

OperationCanceledException

onUserCancel 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.

PathTooLongException

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

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.

SecurityException

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

Exemples

Dans cet exemple, le fichier nommé Test.txt est déplacé de TestDir1 vers TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

Cet exemple montre comment déplacer le fichier Test.txt de TestDir1 à TestDir2 et le Test2.txtrenommer .

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Remarques

Si la structure cible n’existe pas, elle est créée.

La MoveFile méthode conserve les AE (Access Control Entrées) uniquement lors du déplacement du fichier dans le même volume. Cela inclut les ACÉ hérités, qui deviennent des ACÉ directs lorsqu’ils sont déplacés (les ACÉ directs sont prioritaires sur les ACÉ hérités). Si un fichier est déplacé d’un volume à l’autre, les AE ne sont pas copiés.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.FileSystem.MoveFile méthode .

À	Consultez
Déplacer un fichier	Guide pratique pour déplacer un fichier en Visual Basic

Voir aussi

• UIOption
• UICancelOption