FileCopy-Funktion

Artikel
09/02/2008

Aktualisiert: November 2007

Kopiert eine Datei

Das My.Computer.FileSystem-Objekt ermöglicht bei Datei-E/A-Vorgängen höhere Produktivität und Leistung als FileCopy. Weitere Informationen finden Sie unter My.Computer.FileSystem.CopyFile-Methode.

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

Parameter

Source
Erforderlich. String-Ausdruck, der den Namen der Datei angibt, die kopiert werden soll. Source kann das Verzeichnis bzw. den Ordner und das Laufwerk der Quelldatei enthalten.
Destination
Erforderlich. String-Ausdruck, der den Namen der Zieldatei angibt. Destination kann das Verzeichnis bzw. den Ordner und das Laufwerk der Zieldatei enthalten.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	52	Source oder Destination ist ungültig oder nicht angegeben.
IOException	55	Die Datei ist bereits geöffnet.
FileNotFoundException	53	Die Datei ist nicht vorhanden.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Wenn Sie versuchen, die FileCopy-Funktion auf eine aktuell geöffnete Datei anzuwenden, wird ein Fehler ausgelöst.

Der Einsatz von FileCopy auf dem lokalen Laufwerk setzt volle Vertrauenswürdigkeit voraus.

Beispiel

In diesem Beispiel wird mit der FileCopy-Funktion eine Datei in eine andere kopiert. In diesem Beispiel stellt SrcFile eine Datei dar, die Daten enthält.

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