FileSystem.MoveFile Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

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

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

ArgumentException

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.

ArgumentNullException

destinationFileName è Nothing o una stringa vuota.

FileNotFoundException

Il file di origine non è valido o non esiste.

IOException

Il file è in uso in un altro processo oppure si verifica un errore di I/O.

PathTooLongException

La lunghezza del percorso supera la lunghezza massima definita dal sistema.

NotSupportedException

Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.

SecurityException

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

MoveFile(String, String, UIOption)

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

ArgumentException

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.

ArgumentNullException

destinationFileName è Nothing o una stringa vuota.

FileNotFoundException

Il file di origine non è valido o non esiste.

IOException

Il file è in uso in un altro processo oppure si verifica un errore di I/O.

PathTooLongException

La lunghezza del percorso supera la lunghezza massima definita dal sistema.

NotSupportedException

Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.

SecurityException

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

• UIOption

MoveFile(String, String, Boolean)

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

ArgumentException

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.

ArgumentNullException

destinationFileName è Nothing o una stringa vuota.

FileNotFoundException

Il file di origine non è valido o non esiste.

IOException

Il file è in uso in un altro processo oppure si verifica un errore di I/O.

PathTooLongException

La lunghezza del percorso supera la lunghezza massima definita dal sistema.

NotSupportedException

Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.

SecurityException

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

MoveFile(String, String, UIOption, UICancelOption)

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

ArgumentException

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.

ArgumentNullException

destinationFileName è Nothing o una stringa vuota.

FileNotFoundException

Il file di origine non è valido o non esiste.

IOException

Il file è in uso in un altro processo oppure si verifica un errore di I/O.

OperationCanceledException

onUserCancel è impostato su ThrowException e l'utente ha annullato l'operazione oppure si è verificato un errore di I/O non specificato.

PathTooLongException

La lunghezza del percorso supera la lunghezza massima definita dal sistema.

NotSupportedException

Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.

SecurityException

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

• UIOption
• UICancelOption