FileSystemProxy.MoveFile Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Sposta un file in un nuovo percorso.
Overload
| MoveFile(String, String) |
Sposta un file in un nuovo percorso. |
| MoveFile(String, String, UIOption) |
Sposta un file in un nuovo percorso. |
| MoveFile(String, String, Boolean) |
Sposta un file in un nuovo percorso. |
| MoveFile(String, String, UIOption, UICancelOption) |
Sposta un file in un nuovo percorso. |
MoveFile(String, String)
Sposta un file in un nuovo percorso.
public:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);public void MoveFile (string sourceFileName, string destinationFileName);member this.MoveFile : string * string -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String)Parametri
- sourceFileName
- String
Percorso del file da spostare.
- destinationFileName
- String
Percorso della directory in cui spostare il file.
Eccezioni
Il percorso non è valido per uno dei motivi seguenti: è una stringa di lunghezza zero; contiene solo spazi vuoti; contiene caratteri non validi; o è un percorso del dispositivo (inizia con \\.\); termina con una barra finale.
destinationFileName è Nothing o una stringa vuota.
Il file di origine non è valido o non esiste.
Il file è in uso in un altro processo oppure si verifica un errore di I/O.
La lunghezza del percorso supera la lunghezza massima definita dal sistema.
Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.
L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.
Esempio
In questo esempio il file Test.txt viene spostato da TestDir1 a TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
Questo esempio sposta il file Test.txt da TestDir1 a TestDir2 e lo rinomina Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Commenti
Se la struttura di destinazione non esiste, viene creata.
Il MoveFile metodo mantiene gli ACL (Controllo di accesso voci) solo quando si sposta il file nello stesso volume. Sono inclusi gli ACL ereditati, che diventano aces diretti quando vengono spostati (gli ACL diretti hanno la precedenza sugli ACL ereditati). Se un file viene spostato tra volumi, gli ACL non verranno copiati.
La tabella seguente elenca un esempio di un'attività che coinvolge il My.Computer.FileSystem.MoveFile metodo .
| A | Vedere |
|---|---|
| Spostare un file | Procedura: Spostare un file |
Vedi anche
Si applica a
MoveFile(String, String, UIOption)
Sposta un file in un nuovo percorso.
public:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)Parametri
- sourceFileName
- String
Percorso del file da spostare.
- destinationFileName
- String
Percorso della directory in cui spostare il file.
- showUI
- UIOption
Specifica se tenere traccia in modo visivo dello stato dell'operazione. Il valore predefinito è UIOption.OnlyErrorDialogs.
Eccezioni
Il percorso non è valido per uno dei motivi seguenti: è una stringa di lunghezza zero; contiene solo spazi vuoti; contiene caratteri non validi; o è un percorso del dispositivo (inizia con \\.\); termina con una barra finale.
destinationFileName è Nothing o una stringa vuota.
Il file di origine non è valido o non esiste.
Il file è in uso in un altro processo oppure si verifica un errore di I/O.
La lunghezza del percorso supera la lunghezza massima definita dal sistema.
Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.
L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.
Esempio
In questo esempio il file Test.txt viene spostato da TestDir1 a TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
Questo esempio sposta il file Test.txt da TestDir1 a TestDir2 e lo rinomina Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Commenti
Se la struttura di destinazione non esiste, viene creata.
Il MoveFile metodo mantiene gli ACL (Controllo di accesso voci) solo quando si sposta il file nello stesso volume. Sono inclusi gli ACL ereditati, che diventano aces diretti quando vengono spostati (gli ACL diretti hanno la precedenza sugli ACL ereditati). Se un file viene spostato tra volumi, gli ACL non verranno copiati.
La tabella seguente elenca un esempio di un'attività che coinvolge il My.Computer.FileSystem.MoveFile metodo .
| A | Vedere |
|---|---|
| Spostare un file | Procedura: Spostare un file |
Vedi anche
- UIOption
- Oggetti (Visual Basic)
- Creazione, eliminazione e spostamento di file e directory in Visual Basic
Si applica a
MoveFile(String, String, Boolean)
Sposta un file in un nuovo percorso.
public:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);public void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);member this.MoveFile : string * string * bool -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)Parametri
- sourceFileName
- String
Percorso del file da spostare.
- destinationFileName
- String
Percorso della directory in cui spostare il file.
- overwrite
- Boolean
True per sovrascrivere i file esistenti; in caso contrario, False. Il valore predefinito è False.
Eccezioni
Il percorso non è valido per uno dei motivi seguenti: è una stringa di lunghezza zero; contiene solo spazi vuoti; contiene caratteri non validi; o è un percorso del dispositivo (inizia con \\.\); termina con una barra finale.
destinationFileName è Nothing o una stringa vuota.
Il file di origine non è valido o non esiste.
Il file è in uso in un altro processo oppure si verifica un errore di I/O.
La lunghezza del percorso supera la lunghezza massima definita dal sistema.
Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.
L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.
Esempio
In questo esempio il file Test.txt viene spostato da TestDir1 a TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
Questo esempio sposta il file Test.txt da TestDir1 a TestDir2 e lo rinomina Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Commenti
Se la struttura di destinazione non esiste, viene creata.
Il MoveFile metodo mantiene gli ACL (Controllo di accesso voci) solo quando si sposta il file nello stesso volume. Sono inclusi gli ACL ereditati, che diventano aces diretti quando vengono spostati (gli ACL diretti hanno la precedenza sugli ACL ereditati). Se un file viene spostato tra volumi, gli ACL non verranno copiati.
Nella tabella seguente sono elencati alcuni esempi di un'attività che coinvolge il My.Computer.FileSystem.MoveFile metodo.
| A | Vedere |
|---|---|
| Spostare un file | Procedura: Spostare un file |
Vedi anche
Si applica a
MoveFile(String, String, UIOption, UICancelOption)
Sposta un file in un nuovo percorso.
public:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)Parametri
- sourceFileName
- String
Percorso del file da spostare.
- destinationFileName
- String
Percorso della directory in cui spostare il file.
- showUI
- UIOption
Specifica se tenere traccia in modo visivo dello stato dell'operazione. Il valore predefinito è UIOption.OnlyErrorDialogs.
- onUserCancel
- UICancelOption
Specifica se viene generata un'eccezione quando l'utente annulla l'operazione. Il valore predefinito è UICancelOption.ThrowException.
Eccezioni
Il percorso non è valido per uno dei motivi seguenti: è una stringa di lunghezza zero; contiene solo spazi vuoti; contiene caratteri non validi; o è un percorso del dispositivo (inizia con \\.\); termina con una barra finale.
destinationFileName è Nothing o una stringa vuota.
Il file di origine non è valido o non esiste.
Il file è in uso in un altro processo oppure si verifica un errore di I/O.
onUserCancel è impostato su ThrowException e l'utente ha annullato l'operazione oppure si è verificato un errore di I/O non specificato.
La lunghezza del percorso supera la lunghezza massima definita dal sistema.
Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.
L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.
Esempio
In questo esempio il file Test.txt viene spostato da TestDir1 a TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
Questo esempio sposta il file Test.txt da TestDir1 a TestDir2 e lo rinomina Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Commenti
Se la struttura di destinazione non esiste, viene creata.
Il MoveFile metodo mantiene gli ACL (Controllo di accesso voci) solo quando si sposta il file all'interno dello stesso volume. Sono inclusi gli ACL ereditati, che diventano ACL diretti quando vengono spostati (gli ACL diretti hanno la precedenza sugli ACL ereditati). Se un file viene spostato tra volumi, gli ACL non verranno copiati.
Nella tabella seguente è riportato un esempio di attività che include il My.Computer.FileSystem.MoveFile metodo .
| A | Vedere |
|---|---|
| Spostare un file | Procedura: Spostare un file |
