My.Computer.FileSystem.MoveDirectory, méthode

Article
09/12/2008

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.

Pour	Reportez-vous à
Déplacer un répertoire	Comment : déplacer un répertoire dans Visual Basic

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

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
FileIOPermission	Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted.
UIPermission	Contrôle les autorisations relatives aux interfaces utilisateur et au Presse-papiers. Énumération associée : SafeSubWindows.