FileSystem.MoveFile Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Déplace un fichier vers un nouvel emplacement.
Surcharges
| Nom | Description |
|---|---|
| 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
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- 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 -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)Paramètres
- sourceFileName
- String
Chemin d’accès du fichier à déplacer.
- destinationFileName
- String
Chemin du répertoire dans lequel le fichier doit être déplacé.
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 \\.\) ; il se termine par une barre oblique de fin.
destinationFileName est Nothing ou une chaîne vide.
Le fichier source n’est pas valide ou n’existe pas.
Le fichier est utilisé par un autre processus ou une erreur d’E/S se produit.
Le chemin dépasse la longueur maximale définie par le système.
Un nom de fichier ou de répertoire 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.
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.txtTestDir1 vers 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 méthode MoveFile conserve les AE (entrées Access Control) uniquement lors du déplacement du fichier dans le même volume. Cela inclut les AE héritées, qui deviennent des AE directes lorsqu’elles sont déplacées (les acEs directes sont prioritaires sur les ACL héritées). Si un fichier est déplacé entre les volumes, les ACL ne sont pas copiées.
Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.FileSystem.MoveFile méthode.
| À | Consultez |
|---|---|
| Déplacer un fichier | How to : Move a File in Visual Basic |
S’applique à
MoveFile(String, String, UIOption)
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- 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 -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)Paramètres
- sourceFileName
- String
Chemin d’accès du fichier à déplacer.
- destinationFileName
- String
Chemin du répertoire dans lequel le fichier doit être déplacé.
- showUI
- UIOption
Spécifie 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 \\.\) ; il se termine par une barre oblique de fin.
destinationFileName est Nothing ou une chaîne vide.
Le fichier source n’est pas valide ou n’existe pas.
Le fichier est utilisé par un autre processus ou une erreur d’E/S se produit.
Le chemin dépasse la longueur maximale définie par le système.
Un nom de fichier ou de répertoire 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.
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.txtTestDir1 vers 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 méthode MoveFile conserve les AE (entrées Access Control) uniquement lors du déplacement du fichier dans le même volume. Cela inclut les AE héritées, qui deviennent des AE directes lorsqu’elles sont déplacées (les acEs directes sont prioritaires sur les ACL héritées). Si un fichier est déplacé entre les volumes, les ACL ne sont pas copiées.
Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.FileSystem.MoveFile méthode.
| À | Consultez |
|---|---|
| Déplacer un fichier | How to : Move a File in Visual Basic |
Voir aussi
S’applique à
MoveFile(String, String, Boolean)
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- 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 -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)Paramètres
- sourceFileName
- String
Chemin d’accès du fichier à déplacer.
- destinationFileName
- String
Chemin du 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
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 \\.\) ; il se termine par une barre oblique de fin.
destinationFileName est Nothing ou une chaîne vide.
Le fichier source n’est pas valide ou n’existe pas.
Le fichier est utilisé par un autre processus ou une erreur d’E/S se produit.
Le chemin dépasse la longueur maximale définie par le système.
Un nom de fichier ou de répertoire 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.
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.txtTestDir1 vers 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 méthode MoveFile conserve les AE (entrées Access Control) uniquement lors du déplacement du fichier dans le même volume. Cela inclut les AE héritées, qui deviennent des AE directes lorsqu’elles sont déplacées (les acEs directes sont prioritaires sur les ACL héritées). Si un fichier est déplacé entre les volumes, les ACL ne sont pas copiées.
Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.FileSystem.MoveFile méthode.
| À | Consultez |
|---|---|
| Déplacer un fichier | How to : Move a File in Visual Basic |
S’applique à
MoveFile(String, String, UIOption, UICancelOption)
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- 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 -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)Paramètres
- sourceFileName
- String
Chemin d’accès du fichier à déplacer.
- destinationFileName
- String
Chemin du répertoire dans lequel le fichier doit être déplacé.
- showUI
- UIOption
Spécifie s’il faut suivre visuellement la progression de l’opération. La valeur par défaut est UIOption.OnlyErrorDialogs.
- onUserCancel
- UICancelOption
Spécifie si une exception est levée ou non lorsque l’utilisateur annule l’opération. La valeur par défaut est UICancelOption.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 \\.\) ; il se termine par une barre oblique de fin.
destinationFileName est Nothing ou une chaîne vide.
Le fichier source n’est pas valide ou n’existe pas.
Le fichier est utilisé par un autre processus ou une erreur d’E/S se produit.
onUserCancel est défini sur ThrowException, et l’utilisateur a annulé l’opération ou une erreur d’E/S non spécifiée se produit.
Le chemin dépasse la longueur maximale définie par le système.
Un nom de fichier ou de répertoire 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.
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.txtTestDir1 vers 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 méthode MoveFile conserve les AE (entrées Access Control) uniquement lors du déplacement du fichier dans le même volume. Cela inclut les AE héritées, qui deviennent des AE directes lorsqu’elles sont déplacées (les acEs directes sont prioritaires sur les ACL héritées). Si un fichier est déplacé entre les volumes, les ACL ne sont pas copiées.
Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.FileSystem.MoveFile méthode.
| À | Consultez |
|---|---|
| Déplacer un fichier | How to : Move a File in Visual Basic |
