Partager via

FileSystemProxy.MoveFile Méthode

  • Référence

Définition

Espace de noms:
Microsoft.VisualBasic.MyServices
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.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)

Déplace un fichier vers un nouvel emplacement.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);
public void MoveFile (string sourceFileName, string destinationFileName);
member this.MoveFile : string * string -> unit
Public 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 Procédure : déplacer un fichier

Voir aussi

S’applique à

MoveFile(String, String, UIOption)

Déplace un fichier vers un nouvel emplacement.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);
member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public 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 Procédure : déplacer un fichier

Voir aussi

S’applique à

MoveFile(String, String, Boolean)

Déplace un fichier vers un nouvel emplacement.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);
public void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);
member this.MoveFile : string * string * bool -> unit
Public 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 des exemples de tâche impliquant la My.Computer.FileSystem.MoveFile méthode .

À Consultez
Déplacer un fichier Procédure : déplacer un fichier

Voir aussi

S’applique à

MoveFile(String, String, UIOption, UICancelOption)

Déplace un fichier vers un nouvel emplacement.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public 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 Procédure : déplacer un fichier

Voir aussi

S’applique à