FileSystem.MoveFile Metodo

Definizione

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)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

Sposta un file in un nuovo percorso.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);
public static void MoveFile (string sourceFileName, string destinationFileName);
static member MoveFile : string * string -> unit
Public Shared 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: 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 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 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 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 in Visual Basic

Si applica a

MoveFile(String, String, UIOption)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

Sposta un file in un nuovo percorso.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);
static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public Shared 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: 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 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 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 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 in Visual Basic

Vedi anche

Si applica a

MoveFile(String, String, Boolean)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

Sposta un file in un nuovo percorso.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);
public static void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);
static member MoveFile : string * string * bool -> unit
Public Shared 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: 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 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 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 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 in Visual Basic

Si applica a

MoveFile(String, String, UIOption, UICancelOption)

Source:
FileSystem.vb
Source:
FileSystem.vb
Source:
FileSystem.vb

Sposta un file in un nuovo percorso.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Shared 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: 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 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 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 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 in Visual Basic

Vedi anche

Si applica a