Metodo My.Computer.FileSystem.MoveDirectory

Articolo
09/12/2008

Aggiornamento: novembre 2007

Consente di spostare una directory da un percorso a un altro.

' 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 _
)

Parametri

sourceDirectoryName
String. Percorso della directory da spostare. Obbligatorio.
destinationDirectoryName
String. Percorso della directory in cui spostare la directory di origine. Obbligatorio.
overwrite
Boolean. Specifica se le directory esistenti devono essere sovrascritte. Il valore predefinito è False. Obbligatorio.
showUI
UIOption. Specifica se eseguire il monitoraggio dell'avanzamento dell'operazione. Il valore predefinito è UIOption.OnlyErrorDialogs. Obbligatorio.
onUserCancel
Enumerazione UICancelOption. Consente di specificare se generare un'eccezione quando l'utente annulla l'operazione. Il valore predefinito è UICancelOption.ThrowException. Obbligatorio.

Eccezioni

Le seguenti condizioni possono generare un'eccezione:

Il percorso è una stringa di lunghezza zero, contiene solo spazi o caratteri non validi, oppure corrisponde a un percorso di periferica, ossia inizia con \\.\ (ArgumentException).
Il percorso è Nothing (ArgumentNullException).
L'origine non è valida (DirectoryNotFoundException).
L'origine è una directory principale (IOException).
Il percorso combinato punta a un file esistente (IOException).
Il percorso di origine e il percorso di destinazione sono gli stessi (IOException).
Il file esiste già e overwrite è impostato su False (IOException).
onUserCancel è impostato su ThrowException e non è possibile copiare una sottodirectoy del file (IOException).
Questa operazione è ciclica (InvalidOperationException).
Un nome file o directory nel percorso contengono il carattere dei due punti (:) (NotSupportedException).
UICancelOption è impostato su ThrowException e l'utente annulla l'operazione oppure non è possibile completarla (OperationCanceledException).
La lunghezza del percorso supera la lunghezza massima definita dal sistema (PathTooLongException).
UICancelOption è impostato su ThrowException e l'utente non dispone delle autorizzazioni necessarie SecurityException).
L'utente non dispone dell'autorizzazione per la modifica del file (UnauthorizedAccessException).

Note

Se si tenta di spostare una directory all'interno di una directory inesistente, viene creata la struttura di destinazione.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo My.Computer.FileSystem.MoveDirectory.

Per	Vedere
Spostare una directory	Procedura: spostare una directory in Visual Basic

Esempio

Nell'esempio Directory1 viene spostata in Directory2.

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

Nell'esempio Directory1 viene spostata in Directory2 sovrascrivendo l'eventuale directory già esistente.

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

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce accesso a FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilità per tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione console	Sì
Libreria di controlli Windows	Sì
Libreria di controlli Web	Sì
Servizio Windows	Sì
Sito Web	Sì

Autorizzazioni

Potrebbero essere necessarie le autorizzazioni riportate di seguito:

Autorizzazione	Descrizione
FileIOPermission	Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.
UIPermission	Consente di controllare le autorizzazioni correlate alle interfacce utente e gli Appunti. Enumerazione associata: SafeSubWindows.