MoveFile-Funktion

betrifft

Verschiebt eine oder mehrere Dateien von einem Ort an einen anderen.

 

Syntax

TCEWindows.MoveFile(Source, Destination)

Rückgabewert

Kein

Parameter

Verwendung

Name

Typ

Übergabe

Beschreibung

Erforderlich

Source

String

ByVal

Zeichenfolge für die Dateispezifikation für eine oder mehrere zu verschiebende Dateien, die Platzhalter enthalten kann

Erforderlich

Destination

String

ByVal

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

Anmerkungen

Wenn Quelle Platzhalterzeichen enthält oder Ziel mit einem Pfadtrennzeichen (\) endet, wird angenommen, daß Ziel einen vorhandenen Ordner angibt, in den die übereinstimmenden Dateien verschoben werden sollen. Andernfalls wird angenommen, daß Ziel der Name der zu erstellenden Zieldatei ist. In beiden Fällen können beim Kopieren einer einzelnen Datei drei Dinge passieren:

•      Wenn das Ziel nicht vorhanden ist, wird die Datei verschoben. Dies ist normalerweise der Fall.

•      Wenn Ziel eine bereits vorhandene Datei darstellt, kommt es zu einem Fehler.

•      Wenn es sich beim Ziel um ein Verzeichnis handelt, kommt es zu einem Fehler.

Es kommt außerdem zu einem Fehler, wenn ein in Quelle verwendetes Platzhalterzeichen mit keiner der Dateien übereinstimmt. Die MoveFile-Methode hält beim ersten aufgetretenen Fehler an. Es wird nicht versucht, Änderungen zurückzusetzen, die vor dem Auftreten eines Fehlers durchgeführt wurden.

Wichtig   Mit dieser Methode können Dateien nur zwischen Datenträgern verschoben werden, wenn dies vom Betriebssystem unterstützt wird.