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
| Nome | Descrizione |
|---|---|
| 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 deve essere spostato il file.
Eccezioni
Il percorso non è valido per uno dei motivi seguenti: si tratta di 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 da un altro processo o si verifica un errore di I/O.
Il percorso supera la lunghezza massima definita dal sistema.
Un nome di file o directory nel percorso contiene due punti (:) o è in un 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 Test2.txtrinomina .
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Commenti
Se la struttura di destinazione non esiste, viene creata.
Il metodo MoveFile 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 .
| Per | Vedi |
|---|---|
| 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 deve essere spostato il file.
- showUI
- UIOption
Specifica se tenere traccia visivamente dello stato dell'operazione. Il valore predefinito è UIOption.OnlyErrorDialogs.
Eccezioni
Il percorso non è valido per uno dei motivi seguenti: si tratta di 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 da un altro processo o si verifica un errore di I/O.
Il percorso supera la lunghezza massima definita dal sistema.
Un nome di file o directory nel percorso contiene due punti (:) o è in un 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 Test2.txtrinomina .
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Commenti
Se la struttura di destinazione non esiste, viene creata.
Il metodo MoveFile 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 .
| Per | Vedi |
|---|---|
| Spostare un file | Procedura: Spostare un file |
Vedi anche
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 deve essere spostato 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: si tratta di 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 da un altro processo o si verifica un errore di I/O.
Il percorso supera la lunghezza massima definita dal sistema.
Un nome di file o directory nel percorso contiene due punti (:) o è in un 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 Test2.txtrinomina .
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Commenti
Se la struttura di destinazione non esiste, viene creata.
Il metodo MoveFile 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 sono elencati alcuni esempi di un'attività che include il My.Computer.FileSystem.MoveFile metodo .
| Per | Vedi |
|---|---|
| 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 deve essere spostato il file.
- showUI
- UIOption
Specifica se tenere traccia visivamente dello stato dell'operazione. Il valore predefinito è UIOption.OnlyErrorDialogs.
- onUserCancel
- UICancelOption
Specifica se viene generata o meno un'eccezione quando l'utente annulla l'operazione. Il valore predefinito è UICancelOption.ThrowException.
Eccezioni
Il percorso non è valido per uno dei motivi seguenti: si tratta di 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 da un altro processo o si verifica un errore di I/O.
onUserCancel è impostato su ThrowExceptione l'utente ha annullato l'operazione o si verifica un errore di I/O non specificato.
Il percorso supera la lunghezza massima definita dal sistema.
Un nome di file o directory nel percorso contiene due punti (:) o è in un 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 Test2.txtrinomina .
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Commenti
Se la struttura di destinazione non esiste, viene creata.
Il metodo MoveFile 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 .
| Per | Vedi |
|---|---|
| Spostare un file | Procedura: Spostare un file |