Metodo My.Computer.FileSystem.CopyFile

Articolo
09/12/2008

Aggiornamento: novembre 2007

Consente di copiare un file in un nuovo percorso.

' Usage
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName)
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,overwrite)
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,showUI)
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,showUI ,onUserCancel)
' Declaration
Public Sub CopyFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub CopyFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub CopyFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub CopyFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Parametri

sourceFileName
String. File da copiare. Obbligatorio
destinationFileName
String. Percorso in cui copiare il file. Obbligatorio.
overwrite
Boolean. Consente di determinare se i file esistenti dovranno essere sovrascritti. Il valore predefinito è False. Obbligatorio.
showUI
UIOption. Consente di specificare se eseguire il monitoraggio dell'avanzamento dell'operazione. Il valore predefinito è UIOption.OnlyErrorDialogs. Obbligatorio.
onUserCancel
UICancelOption. Specifica le azioni da intraprendere se l'utente fa clic su Annulla durante l'operazione. Il valore predefinito è ThrowException. Obbligatorio.

Eccezioni

Le seguenti condizioni possono causare la generazione di un'eccezione:

Il percorso non è valido per uno dei seguenti motivi: è una stringa di lunghezza zero, contiene solo spazi vuoti, contiene caratteri non validi o è il percorso di una periferica, vale a dire inizia con \\.\) (ArgumentException).
Il sistema non è stato in grado di recuperare il percorso assoluto (ArgumentException).
destinationFileName contiene informazioni sul percorso (ArgumentException).
Il percorso non è valido in quanto Nothing (ArgumentNullException).
destinationFileName è Nothing o una stringa vuota (ArgumentNullException).
Il file di origine non è valido o non esiste (FileNotFoundException).
Dal percorso combinato viene scelta una directory esistente (IOException).
Il file di destinazione esiste e overwrite è impostato su False (IOException).
L'utente non dispone di autorizzazioni sufficienti per accedere al file (IOException).
Un file nella directory di destinazione con lo stesso nome è in uso (IOException).
Un nome di file o di directory nel percorso contiene i due punti (:) o ha un formato non valido (NotSupportedException).
UICancelOption è impostato su ThrowException e l'utente ha annullato l'operazione (OperationCanceledException).
UICancelOption è impostato su ThrowException e si verifica un errore I/O non specificato (OperationCanceledException).
La lunghezza del percorso supera la lunghezza massima definita dal sistema (PathTooLongException).
L'utente non dispone delle autorizzazioni necessarie (UnauthorizedAccessException).
L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso (SecurityException).

Note

CopyFile non mantiene le voci di controllo dell'accesso (ACE, Access Control Entries). Il file appena creato eredita le voci di controllo dell'accesso predefinite dalla directory nella quale è creato.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo My.Computer.FileSystem.CopyFile.

Per	Vedere
Copiare un file nella stessa directory.	Procedura: creare una copia di un file nella stessa directory in Visual Basic
Copiare un file in una directory diversa.	Procedura: creare una copia di un file in una directory diversa in Visual Basic

Esempio

Nell'esempio viene copiato il file Test.txt nella directory TestFiles2 senza sovrascrivere file esistenti.

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

Sostituire i percorsi di file con i percorsi che si desidera utilizzare nel codice.

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

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

Sostituire i percorsi di file con i percorsi che si desidera utilizzare nel codice.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce accesso a FileSystem)

Assembly: la libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità in base al tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione di console	Sì
Libreria di controlli Windows	Sì
Libreria di controllo Web	Sì
Servizio Windows	Sì
Sito Web	Sì

Autorizzazioni

Potrebbero essere necessarie le autorizzazioni riportate di seguito:

Autorizzazione	Descrizione
EnvironmentPermission	Consente di controllare la capacità di accedere a tutte le variabili di ambiente. Enumerazione associata: Unrestricted.
FileIOPermission	Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.
RegistryPermission	Consente di controllare la capacità di accedere a tutte le variabili di registro. Enumerazione associata: Unrestricted.
UIPermission	Consente di controllare le autorizzazioni correlate alle interfacce utente e gli Appunti. Enumerazione associata: SafeSubWindows.