CopyFile-Methode

  • Artikel

Kopiert eine oder mehrere Dateien von einem Speicherort an einen anderen.

Syntax

-Objekt.CopyFile-Quelle, Ziel, [ überschreiben ]

Die Syntax der CopyFile-Methode besteht aus folgenden Teilen:

Teil Beschreibung
Objekt Erforderlich. Das -Objekt ist immer der Name eines FileSystemObject.
source Erforderlich. Spezifikation der Zeichenfolgendatei, die Für eine oder mehrere zu kopierende Dateien Ein-/Auslesezeichen enthalten kann.
destination Erforderlich. Als Zeichenfolge angegebenes Ziel, an das die Datei oder Dateien aus source kopiert werden. Platzhalterzeichen sind nicht zulässig.
Überschreiben Optional. Boolescher Wert, der angibt, ob vorhandene Dateien überschrieben werden sollen. True gibt an, dass Dateien überschrieben werden. , wenn False, sind sie nicht. Der Standardwert ist True. Beachten Sie, dass CopyFile fehlschlägt, wenn für das Ziel das schreibgeschützte Attribut festgelegt ist, unabhängig vom Wert von overwrite.

HinwBemerkungeneise

Platzhalterzeichen können nur in der letzten Pfadkomponente des Arguments Quelle verwendet werden. Sie können z. B. Folgendes angeben:

FileSystemObject.CopyFile "c:\mydocuments\letters\*.doc", "c:\tempfolder\"

Folgendes können Sie nicht verwenden:

FileSystemObject.CopyFile "c:\mydocuments\*\R1???97.xls", "c:\tempfolder"

Wenn die Quelle Einen Feldhalterzeichen enthält oder das Ziel mit einem Pfadtrennzeichen (****) endet, wird davon ausgegangen, dass ziel ein vorhandener Ordner ist, in den übereinstimmende Dateien kopiert werden. Andernfalls wird destination als Name einer zu erstellenden Datei angesehen. In beiden Fällen können drei Dinge passieren, wenn eine einzelne Datei kopiert wird:

  • Ist destination nicht vorhanden, wird source kopiert. Das ist der Regelfall.

  • Ist destination eine vorhandene Daei, tritt ein Fehler auf, wenn overwrite auf False festgelegt ist. Andernfalls wird versucht, die vorhandene Datei mit source zu überschreiben.

  • Ist destination ein Verzeichnis, tritt ein Fehler auf.

Ein Fehler tritt auch auf, wenn Platzhalterzeichen in source mit keiner Datei übereinstimmen. Die CopyFile-Methode hält beim ersten auftretenden Fehler an. Es wird nicht versucht, den Vorgang zurückzusetzen oder Änderungen rückgängig zu machen, die vor dem Fehler vorgenommen wurden.

Dateien, die in einen neuen Zielpfad kopiert werden, behalten denselben Dateinamen bei. Um die kopierte Datei umzubenennen, fügen Sie einfach den neuen Dateinamen in den Zielpfad ein. Dadurch wird z. B. die Datei an einen neuen Speicherort kopiert , und die Datei am neuen Speicherort hat einen anderen Namen:

FileSystemObject.CopyFile "c:\mydocuments\letters\sample.doc", "c:\tempfolder\sample_new.doc"

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.