Metodo My.Computer.FileSystem.MoveFile

Articolo
09/12/2008

Aggiornamento: novembre 2007

Consente di spostare un file in un nuovo percorso.

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

Parametri

sourceFileName
String. Percorso del file da spostare. Obbligatorio.
destinationFileName
String. Percorso della directory in cui spostare il file. Obbligatorio.
overwrite
Boolean. Specifica se sovrascrivere i file esistenti. Il valore predefinito è False. Obbligatorio.
showUI
Enumerazione UIOption. Specifica se eseguire il monitoraggio dell'avanzamento dell'operazione. Il valore predefinito è UIOption.OnlyErrorDialogs. Obbligatorio.
onUserCancel
Enumerazione UICancelOption. Specifica 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 non è valido per uno dei seguenti motivi: è una stringa di lunghezza zero, contiene solo spazi vuoti, contiene caratteri non validi o è il percorso di una periferica, vale a dire inizia con \\.\ (ArgumentException).
Il nome del file termina con una barra rovesciata (\) (ArgumentException).
Il percorso non è valido in quanto Nothing (ArgumentNullException).
destinationFileName è Nothing o una stringa vuota (ArgumentNullException).
Il file di origine non è valido o non esiste (FileNotFoundException).
Il percorso combinato fa riferimento a una directory esistente, il file di destinazione esiste già e overwrite è impostato su False, nella directory di destinazione è in uso un file con lo stesso nome oppure l'utente dispone di autorizzazioni di accesso al file insufficienti (IOException).
Un nome di file o di directory nel percorso contiene i due punti (:) o ha un formato non valido (NotSupportedException).
onUserCancel è impostato su ThrowException e l'utente ha annullato l'operazione oppure si è verificato un errore di I/O non specificato (OperationCanceledException).
La lunghezza del percorso supera la lunghezza massima definita dal sistema (PathTooLongException).
L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso (SecurityException).
L'utente non dispone delle autorizzazioni necessarie (UnauthorizedAccessException).

Note

Se la struttura di destinazione non esiste, viene creata.

Il metodo MoveFile mantiene le voci ACE (Access Control Entries) solo quando il file viene spostato all'interno dello stesso volume. Sono incluse le voci ACE ereditate, che dopo lo spostamento diventano dirette. Le voci ACE dirette sono prioritarie rispetto a quelle ereditate. Se si sposta un file tra due volumi, le voci ACE non verranno copiate.

Attività

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

Per	Vedere
Spostare un file	Procedura: spostare un file in Visual Basic
Spostare un insieme di file	Procedura: spostare un insieme di file in Visual Basic
Spostare il contenuto di una directory	Procedura: spostare il contenuto di una directory in Visual Basic

Esempio

Nell'esempio il file Test.txt viene spostato da TestDir1 a TestDir2.

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

Nell'esempio il file Test.txt viene spostato da TestDir1 a TestDir2 e quindi viene rinominato Test2.txt.

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

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
EnvironmentPermission	Consente di controllare la capacità di accedere a tutte le variabili di ambiente. Enumerazione associata: Unrestricted.
FileIOPermission	Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.
RegistryPermission	Consente di controllare la capacità di accedere a tutte le variabili di registro. Enumerazione associata: Unrestricted.
UIPermission	Consente di controllare le autorizzazioni correlate alle interfacce utente e gli Appunti. Enumerazione associata: SafeSubWindows.