Funzione FileCopy

Articolo
09/12/2008

Aggiornamento: novembre 2007

Copia un file.

Nelle operazioni di I/O dei file Oggetto My.Computer.FileSystem offre un più elevato livello di produttività e prestazioni rispetto a FileCopy. Per ulteriori informazioni, vedere Metodo My.Computer.FileSystem.CopyFile.

Public Sub FileCopy( _
   ByVal Source As String, _
   ByVal Destination As String _
)

Parametri

Source
Obbligatorio. Espressione String che specifica il nome del file da copiare. In Source è possibile includere la directory o la cartella e l'unità del file di origine.
Destination
Obbligatorio. Espressione String che specifica il nome del file di destinazione. In Destination è possibile includere la directory o la cartella e l'unità del file di destinazione.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	52	Source o Destination non è valido o non è specificato.
IOException	55	File già aperto.
FileNotFoundException	53	Il file non esiste.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Se si tenta di utilizzare la funzione FileCopy su un file attualmente aperto, verrà generato un errore.

Per utilizzare FileCopy in un'unità locale, è richiesta l'attendibilità totale.

Esempio

Nell'esempio riportato di seguito la funzione FileCopy viene utilizzata per copiare un file in un altro. Ai fini dell'esempio, SrcFile è un file contenente alcuni dati.

Dim SourceFile, DestinationFile As String
SourceFile = "SRCFILE"   ' Define source file name.
DestinationFile = "DESTFILE"   ' Define target file name.
FileCopy(SourceFile, DestinationFile)   ' Copy source to target.