CopyFolder-Methode

Kopiert einen Ordner rekursiv von einem Speicherort an einen anderen.

Syntax

-Objekt.CopyFoldersource, destination, [ overwrite ]

Die Syntax der Methode CopyFolder hat folgende Teile:

Teil Beschreibung
Objekt Erforderlich. Immer der Name eines FileSystemObject.
source Erforderlich. Ordnerangabe (Zeichenfolge) für einen oder mehrere zu kopierende Ordner; kann Platzhalterzeichen enthalten.
destination Erforderlich. Zielordner (Zeichenfolge), in den Ordner und Unterordner aus der Quelle kopiert werden sollen. Platzhalterzeichen sind nicht zulässig.
Überschreiben Optional. Boolescher Wert, der angibt, ob vorhandene Ordner überschrieben werden sollen. True gibt an, dass Dateien überschrieben werden. , wenn False, sind sie nicht. Der Standardwert ist True.

HinwBemerkungeneise

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

FileSystemObject.CopyFolder "c:\mydocuments\letters\*", "c:\tempfolder\"

Folgendes können Sie nicht verwenden:

FileSystemObject.CopyFolder "c:\mydocuments\*\*", "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 Ordner und Unterordner kopiert werden. Andernfalls wird angenommen, dass Ziel der Name eines zu erstellenden Ordners ist. In beiden Fällen können vier Dinge passieren, wenn ein einzelner Ordner kopiert wird:

  • Wenn Ziel nicht existiert, wird der Ordner Quelle mit all seinen Inhalten kopiert. Dies ist der Normalfall.

  • Wenn Ziel eine existierende Datei ist, tritt ein Fehler auf.

  • Wenn Ziel ein Verzeichnis ist, wird versucht, den Ordner mit all seinen Inhalten zu kopieren. Wenn eine Datei aus der Quelle am Ziel bereits existiert, tritt ein Fehler auf, falls overwrite auf False festgelegt ist. Andernfalls wird versucht, die Datei über die existierende Datei zu kopieren.

  • Wenn Ziel ein schreibgeschütztes Verzeichnis ist, tritt ein Fehler auf, falls versucht wird, eine bestehende schreibgeschützte Datei in dieses Verzeichnis zu kopieren und overwrite auf False festgelegt ist.

Zudem tritt ein Fehler auf, wenn eine Quelle mit Platzhalterzeichen zu nicht zu einem Ordner passt.

Die Methode CopyFolder wird beim ersten auftretenden Fehler angehalten. Es wird kein Versuch unternommen, Änderungen, die vor dem Auftreten des Fehlers gemacht wurden, rückgängig zu machen.

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.