FileSystem.CopyFile Metodo

Definizione

Spazio dei nomi:: Microsoft.VisualBasic.FileIO

Assembly:: Microsoft.VisualBasic.dll

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.

Copia un file in un nuovo percorso.

Overload

Nome	Descrizione
CopyFile(String, String)	Copia un file in un nuovo percorso.
CopyFile(String, String, UIOption)	Copia un file in un nuovo percorso.
CopyFile(String, String, Boolean)	Copia un file in un nuovo percorso.
CopyFile(String, String, UIOption, UICancelOption)	Copia un file in un nuovo percorso.

CopyFile(String, String)

Copia un file in un nuovo percorso.

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public static void CopyFile(string sourceFileName, string destinationFileName);

static member CopyFile : string * string -> unit

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String)

Parametri

sourceFileName: String

File da copiare.

destinationFileName: String

Percorso in cui copiare il file.

Eccezioni

ArgumentException

destinationFileName contiene informazioni sul percorso.

ArgumentNullException

destinationFileName oppure sourceFileName è Nothing o una stringa vuota.

FileNotFoundException

Il file di origine non è valido o non esiste.

IOException

Un file nella directory di destinazione con lo stesso nome è in uso.

NotSupportedException

Un nome di file o directory nel percorso contiene due punti (:) o è in un formato non valido.

PathTooLongException

Il percorso supera la lunghezza massima definita dal sistema.

UnauthorizedAccessException

L'utente non dispone dell'autorizzazione necessaria.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

Esempio

In questo esempio il file Test.txt viene copiato nella directory TestFiles2 senza sovrascrivere i file esistenti.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Sostituire i percorsi dei file con i percorsi da usare nel codice.

In questo esempio il file Test.txt viene copiato nella directory TestFiles2 e rinominato NewFile.txt.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Sostituire i percorsi dei file con i percorsi da usare nel codice.

Commenti

CopyFile non mantiene gli ACL (Controllo di accesso voci). Il file appena creato eredita gli ACL predefiniti dalla directory in cui viene creata.

Nella tabella seguente sono elencati esempi di attività che coinvolgono il My.Computer.FileSystem.CopyFile metodo .

Per	Vedi
Copiare un file nella stessa directory.	Come creare una copia di un file nella stessa directory in Visual Basic
Copiare un file in una directory diversa.	Come creare una copia di un file in una directory diversa in Visual Basic

Vedi anche

UICancelOption

Si applica a

CopyFile(String, String, UIOption)

Copia un file in un nuovo percorso.

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public static void CopyFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);

static member CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

Parametri

sourceFileName: String

File da copiare.

destinationFileName: String

Percorso in cui copiare il file.

showUI: UIOption

Indica se tenere traccia visivamente dello stato dell'operazione. Il valore predefinito è UIOption.OnlyErrorDialogs.

Eccezioni

ArgumentException

destinationFileName contiene informazioni sul percorso.

ArgumentNullException

destinationFileName oppure sourceFileName è Nothing o una stringa vuota.

FileNotFoundException

Il file di origine non è valido o non esiste.

IOException

Il file di destinazione esiste ed overwrite è impostato su False.

NotSupportedException

Un nome di file o directory nel percorso contiene due punti (:) o è in un formato non valido.

PathTooLongException

Il percorso supera la lunghezza massima definita dal sistema.

UnauthorizedAccessException

L'utente non dispone dell'autorizzazione necessaria.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

Esempio

In questo esempio il file Test.txt viene copiato nella directory TestFiles2 senza sovrascrivere i file esistenti.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Sostituire i percorsi dei file con i percorsi da usare nel codice.

In questo esempio il file Test.txt viene copiato nella directory TestFiles2 e rinominato NewFile.txt.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Sostituire i percorsi dei file con i percorsi da usare nel codice.

Commenti

CopyFile non mantiene gli ACL (Controllo di accesso voci). Il file appena creato eredita gli ACL predefiniti dalla directory in cui viene creata.

Nella tabella seguente sono elencati esempi di attività che coinvolgono il My.Computer.FileSystem.CopyFile metodo .

Per	Vedi
Copiare un file nella stessa directory.	Come creare una copia di un file nella stessa directory in Visual Basic
Copiare un file in una directory diversa.	Come creare una copia di un file in una directory diversa in Visual Basic

Vedi anche

UICancelOption

Si applica a

CopyFile(String, String, Boolean)

Copia un file in un nuovo percorso.

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);

public static void CopyFile(string sourceFileName, string destinationFileName, bool overwrite);

static member CopyFile : string * string * bool -> unit

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

Parametri

sourceFileName: String

File da copiare.

destinationFileName: String

Percorso in cui copiare il file.

overwrite: Boolean

True se i file esistenti devono essere sovrascritti; in caso contrario False, . Il valore predefinito è False.

Eccezioni

ArgumentException

destinationFileName contiene informazioni sul percorso.

ArgumentNullException

destinationFileName oppure sourceFileName è Nothing o una stringa vuota.

FileNotFoundException

Il file di origine non è valido o non esiste.

IOException

Il file di destinazione esiste ed overwrite è impostato su False.

NotSupportedException

Un nome di file o directory nel percorso contiene due punti (:) o è in un formato non valido.

PathTooLongException

Il percorso supera la lunghezza massima definita dal sistema.

UnauthorizedAccessException

L'utente non dispone dell'autorizzazione necessaria.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

Esempio

In questo esempio il file Test.txt viene copiato nella directory TestFiles2 senza sovrascrivere i file esistenti.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Sostituire i percorsi dei file con i percorsi da usare nel codice.

In questo esempio il file Test.txt viene copiato nella directory TestFiles2 e rinominato NewFile.txt.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Sostituire i percorsi dei file con i percorsi da usare nel codice.

Commenti

CopyFile non mantiene gli ACL (Controllo di accesso voci). Il file appena creato eredita gli ACL predefiniti dalla directory in cui viene creata.

Nella tabella seguente sono elencati esempi di attività che coinvolgono il My.Computer.FileSystem.CopyFile metodo .

Per	Vedi
Copiare un file nella stessa directory.	Come creare una copia di un file nella stessa directory in Visual Basic
Copiare un file in una directory diversa.	Come creare una copia di un file in una directory diversa in Visual Basic

Vedi anche

UICancelOption

Si applica a

CopyFile(String, String, UIOption, UICancelOption)

Copia un file in un nuovo percorso.

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public static void CopyFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

static member CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

Parametri

sourceFileName: String

File da copiare.

destinationFileName: String

Percorso in cui copiare il file.

showUI: UIOption

Indica se tenere traccia visivamente dello stato dell'operazione. Il valore predefinito è UIOption.OnlyErrorDialogs.

onUserCancel: UICancelOption

Specifica le operazioni da eseguire se l'utente fa clic su Annulla durante l'operazione. Il valore predefinito è ThrowException.

Eccezioni

ArgumentException

destinationFileName contiene informazioni sul percorso.

ArgumentNullException

destinationFileName oppure sourceFileName è Nothing o una stringa vuota.

FileNotFoundException

Il file di origine non è valido o non esiste.

IOException

Il file di destinazione esiste ed overwrite è impostato su False.

NotSupportedException

Un nome di file o directory nel percorso contiene due punti (:) o è in un formato non valido.

PathTooLongException

Il percorso supera la lunghezza massima definita dal sistema.

UnauthorizedAccessException

L'utente non dispone dell'autorizzazione necessaria.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

OperationCanceledException

UICancelOption è impostato su ThrowExceptione l'utente ha annullato l'operazione o si verifica un errore di I/O non specificato.

Esempio

In questo esempio il file Test.txt viene copiato nella directory TestFiles2 senza sovrascrivere i file esistenti.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Sostituire i percorsi dei file con i percorsi da usare nel codice.

In questo esempio il file Test.txt viene copiato nella directory TestFiles2 e rinominato NewFile.txt.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Sostituire i percorsi dei file con i percorsi da usare nel codice.

Commenti

CopyFile non mantiene gli ACL (Controllo di accesso voci). Il file appena creato eredita gli ACL predefiniti dalla directory in cui viene creata.

Nella tabella seguente sono elencati esempi di attività che coinvolgono il My.Computer.FileSystem.CopyFile metodo .

Per	Vedi
Copiare un file nella stessa directory.	Come creare una copia di un file nella stessa directory in Visual Basic
Copiare un file in una directory diversa.	Come creare una copia di un file in una directory diversa in Visual Basic

Vedi anche

UICancelOption

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?