Condividi tramite


Metodo My.Computer.FileSystem.CopyFile

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

Libreria di classi

Applicazione di console

Libreria di controlli Windows

Libreria di controllo Web

Servizio Windows

Sito Web

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.

Per ulteriori informazioni, vedere Protezione dall'accesso di codice e Richiesta di autorizzazioni.

Vedere anche

Attività

Procedura: copiare file con un criterio specifico in una directory in Visual Basic

Procedura: creare una copia di un file nella stessa directory in Visual Basic

Procedura: copiare una directory in un'altra directory di Visual Basic

Procedura: rinominare un file in Visual Basic

Riferimenti

Oggetto My.Computer.FileSystem

Enumerazione UICancelOption