My.Computer.FileSystem.MoveDirectory, méthode

Mise à jour : novembre 2007

Déplace un répertoire d'un emplacement à l'autre.

' Usage
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,overwrite)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI ,onUserCancel)

' Declaration
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Paramètres

• sourceDirectoryName
  String. Chemin d'accès au répertoire à déplacer. Obligatoire.

• destinationDirectoryName
  String. Chemin d'accès au répertoire dans lequel le répertoire source est déplacé. Obligatoire.

• overwrite
  Boolean. Spécifie si les répertoires existants doivent être remplacés. La valeur par défaut est False. Obligatoire.

• 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. 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 est une chaîne de longueur nulle, ne contient que des espaces blancs, contient des caractères non valides ou est un chemin d'accès de périphérique (qui commence par \\. \) (ArgumentException) ;

• le chemin d'accès est Nothing (ArgumentNullException) ;

• la source n'est pas valide (DirectoryNotFoundException) ;

• la source est un répertoire racine (IOException) ;

• le chemin d'accès combiné pointe sur un fichier existant (IOException) ;

• le chemin source et le chemin cible sont identiques (IOException) ;

• le fichier existe déjà et verwrite a la valeur False (IOException) ;

• onUserCancel a la valeur ThrowException et un sous-répertoire du fichier ne peut pas être copié (IOException) ;

• l'opération est cyclique (InvalidOperationException) ;

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

• UICancelOption a la valeur ThrowException et l'utilisateur annule l'opération, ou encore l'opération ne peut pas être effectuée (OperationCanceledException) ;

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

• UICancelOption a la valeur ThrowException et l'utilisateur n'a pas les autorisations nécessaires (SecurityException) ;

• l'utilisateur n'est pas autorisé à créer un fichier (UnauthorizedAccessException).

Notes

Si vous tentez de déplacer un répertoire vers un répertoire qui n'existe pas, la structure cible sera créée.

Tâches

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

Exemple

Cet exemple déplace Directory1 dans Directory2.

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")

Cet exemple déplace Directory1 à l'intérieur de Directory2, remplaçant le répertoire s'il existe déjà.

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2", _
True)

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

Autorisations

Les autorisations suivantes peuvent être nécessaires :

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

My.Computer.FileSystem.MoveFile, méthode

My.Computer.FileSystem.CopyDirectory, méthode

Autres ressources

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