Partager via


My.Computer.FileSystem.MoveFile, méthode

Mise à jour : novembre 2007

Déplace un fichier vers un nouvel emplacement.

' Usage
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,overwrite)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,showUI)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,showUI ,onUserCancel)
' Declaration
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Paramètres

  • sourceFileName
    String. Chemin d'accès au fichier à déplacer. Obligatoire.

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

  • overwrite
    Boolean. Spécifie s'il faut remplacer des fichiers existants. La valeur par défaut est False. Obligatoire.

  • showUI
    Énumération 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. Obligatoire.

  • onUserCancel
    Énumération 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. Obligatoire.

Exceptions

Les conditions ci-dessous peuvent générer une exception :

  • Le chemin d'accès n'est pas valide pour 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'accès de périphérique (qui commence par \\.\) (ArgumentException).

  • le nom de fichier se termine par une barre oblique inverse (ArgumentException) ;

  • le chemin d'accès n'est pas valide, car il a la valeur Nothing (ArgumentNullException) ;

  • destinationFileName a la valeur Nothing ou est une chaîne vide (ArgumentNullException) ;

  • le fichier source n'est pas valide ou n'existe pas (FileNotFoundException) ;

  • le chemin d'accès combiné pointe sur un répertoire existant, le fichier de destination existe et overwrite a la valeur False, un fichier du répertoire cible portant le même nom est en cours d'utilisation, ou l'utilisateur n'a pas les autorisations suffisantes pour accéder au fichier (IOException) ;

  • un nom de fichier ou de répertoire du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct (NotSupportedException) ;

  • onUserCancel a la valeur ThrowException et l'utilisateur a annulé l'opération ou une erreur E/S non spécifiée se produit (OperationCanceledException) ;

  • le chemin d'accès dépasse la longueur maximale définie par le système (PathTooLongException) ;

  • l'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès (SecurityException) ;

  • l'utilisateur n'a pas l'autorisation requise (UnauthorizedAccessException) ;

Notes

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

La méthode MoveFile conserve les entrées du contrôle d'accès (ACE, Access Control Entries) uniquement lors du déplacement du fichier dans le même volume. Cela inclut des entrées du contrôle d'accès (ACE) héritées, qui deviennent des entrées directes lorsqu'elles sont déplacées (les entrées du contrôle d'accès directes ont la priorité sur celles qui sont héritées). Si un fichier est déplacé entre les volumes, les entrées du contrôle d'accès ne seront pas copiées.

Tâches

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

Pour

Reportez-vous à

Déplacer un fichier

Comment : déplacer un fichier dans Visual Basic

Déplacer une collection de fichiers

Comment : déplacer une collection de fichiers dans Visual Basic

Déplacer le contenu d'un répertoire

Comment : déplacer le contenu d'un répertoire dans Visual Basic

Exemple

Cet exemple déplace le fichier Test.txt de TestDir1 vers TestDir2.

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

Cet exemple déplace le fichier Test.txt de TestDir1 vers TestDir2 et le renomme Test2.txt.

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

Configuration requise

Espace de noms :Microsoft.VisualBasic.MyServices

Classe :FileSystemProxy (fournit l'accès à FileSystem)

Assembly : bibliothèque Runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet

Disponible

Application Windows

Oui

Bibliothèque de classes

Oui

Application console

Oui

Bibliothèque de contrôles Windows

Oui

Bibliothèque de contrôles Web

Oui

Service Windows

Oui

Site Web

Oui

Autorisations

Les autorisations suivantes peuvent être nécessaires :

Autorisation

Description

EnvironmentPermission

Contrôle la possibilité d'accéder à toutes les variables d'environnement. Énumération associée : Unrestricted.

FileIOPermission

Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted.

RegistryPermission

Contrôle la possibilité d'accéder aux variables du Registre. Énumération associée : Unrestricted.

UIPermission

Contrôle les autorisations relatives aux interfaces utilisateur et au Presse-papiers. Énumération associée : SafeSubWindows.

Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.

Voir aussi

Référence

My.Computer.FileSystem, objet

UIOption, énumération

UICancelOption, énumération

Autres ressources

Création, suppression et déplacement de fichiers et de répertoires en Visual Basic