CopyFolder-Funktion

betrifft

Die CopyFolder-Funktion kopiert einen Ordner an einen anderen Ort.

 

Syntax

TCEWindows.CopyFolder(Source, Destination, [OverwriteFiles = True])

Rückgabewert

Kein

Parameter

Verwendung

Name

Typ

Übergabe

Beschreibung

Erforderlich

Source

String

ByVal

Zeichenfolge für die Dateispezifikation für einen oder mehrere zu kopierende Ordner, die Platzhalter enthalten kann

Erforderlich

Destination

String

ByVal

Zeichenfolge für das Ziel, an das die Ordner kopiert werden sollen. Platzhalter sind nicht erlaubt

Optional

OverwriteFiles

Boolean

ByVal

Gibt an, ob die Ordner überschrieben werden sollen. Die Voreinstellung ist True

 

Anmerkungen

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

TCEWindows.CopyFolder("c:\mydocuments\letters\*", "c:\tempfolder\")

Nicht aber:

TCEWindows.CopyFolder("c:\mydocuments\*\*", "c:\tempfolder\")

Wenn Source Platzhalterzeichen enthält oder Destination mit einem Pfadtrennzeichen (\) endet, wird angenommen, dass Destination ein vorhandener Ordner ist, in den übereinstimmende Ordner und Unterordner kopiert werden sollen. Andernfalls wird angenommen, dass Destination der Name eines zu erstellenden Ordners ist. In beiden Fällen können beim Kopieren eines einzelnen Ordners vier Dinge passieren.

•      Wenn es Destination nicht gibt, wird Source und sein gesamter Inhalt kopiert. Dies ist normalerweise der Fall.

•      Wenn Destination eine vorhandene Datei ist, kommt es zu einem Fehler.

•      Wenn es sich bei Destination um ein Verzeichnis handelt, wird versucht, den Ordner und seinen gesamten Inhalt zu kopieren. Wenn eine in Quelle enthaltene Datei bereits in Ziel vorhanden ist, kommt es zu einem Fehler, wenn überschreiben False ist. Andernfalls wird versucht, die Datei über die vorhandene Datei zu kopieren.

•      Wenn es sich bei Destination um ein schreibgeschütztes Verzeichnis handelt, kommt es zu einem Fehler, wenn Sie versuchen, eine vorhandene schreibgeschützte Datei in dieses Verzeichnis zu kopieren und überschreiben False ist.

Es kommt außerdem zu einem Fehler, wenn Source, die Platzhalterzeichen verwendet, mit keinem der Ordner übereinstimmt.

Die CopyFolder-Methode hält beim ersten aufgetretenen Fehler an. Es wird nicht versucht, Änderungen zurückzusetzen oder aufzuheben, die vor dem Auftreten eines Fehlers durchgeführt wurden.