FileMoveDir

Verschiebt einen Ordner mit all seinen Unterordnern und Dateien. Kann einen Ordner auch umbenennen.

FileMoveDir, Quelle, Ziel , ÜberschreibenOderUmbenennen

Parameter

Quelle

Name des Quellverzeichnisses (ohne umgekehrten Schrägstrich am Ende). Wenn kein absoluter Pfad angegeben ist, wird das Verzeichnis im A_WorkingDir-Verzeichnis vermutet. Zum Beispiel: C:\Mein Ordner

Ziel

Der neue Pfad und Name des Verzeichnisses (ohne umgekehrten Schrägstrich am Ende). Wenn kein absoluter Pfad angegeben ist, wird das Verzeichnis im A_WorkingDir-Verzeichnis vermutet. Zum Beispiel: D:\Mein Ordner.

Hinweis: Ziel ist der tatsächliche Pfad und Name, den das Verzeichnis nach dem Verschieben haben wird; es ist nicht das Verzeichnis, in das Quelle verschoben wurde (mit Ausnahme der unten erwähnten bekannten Einschränkung).

ÜberschreibenOderUmbenennen

Wenn leer oder weggelassen, wird standardmäßig 0 verwendet. Andernfalls geben Sie einen der folgenden Werte an, um festzulegen, ob bereits vorhandene Dateien überschrieben oder umbenannt werden dürfen:

0: Vorhandene Dateien werden nicht überschrieben. Die Operation wird fehlschlagen, wenn Ziel bereits als Datei oder Verzeichnis existiert.

1: Vorhandene Dateien werden überschrieben. Allerdings werden Dateien oder Unterordner innerhalb von Ziel, die kein Gegenstück in Quelle haben, nicht gelöscht. Bekannte Einschränkung: Wenn Ziel bereits als Ordner existiert und sich auf demselben Datenträger wie Quelle befindet, wird Quelle in diesen Ordner verschoben, anstatt ihn zu überschreiben. Um das zu umgehen, verwenden Sie die nächste Option.

2: Wie der Modus 1 oben, aber ohne die Einschränkung.

R: Benennt den Ordner um, anstatt ihn zu verschieben. Obwohl das Umbenennen normalerweise den gleichen Effekt wie das Verschieben hat, ist diese Option hilfreich, wenn ein "Alles oder nichts"-Verhalten benötigt wird; d.h. wenn Sie nicht wollen, dass die Operation nur teilweise erfolgreich ist, wenn Quelle oder eine ihrer Dateien gesperrt (in Benutzung) ist. Mit dieser Methode kann Quelle nur in ein anderes Verzeichnis auf demselben Datenträger verschoben werden, nicht auf einen anderen Datenträger. Die Operation wird fehlschlagen, wenn Ziel bereits als Datei oder Verzeichnis existiert.

Fehlerbehandlung

[v1.1.04+]: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter Laufzeitfehler.

ErrorLevel wird bei Misserfolg auf 1 und bei Erfolg auf 0 gesetzt.

Bemerkungen

FileMoveDir verschiebt nur einen einzelnen Ordner an einen neuen Ort. Um stattdessen den kompletten Inhalt eines Ordners (all seine Dateien und Unterordner) zu verschieben, verwenden Sie das Beispiel ganz am Ende der FileMove-Seite.

Wenn sich Quelle und Ziel auf unterschiedlichen Datenträgern oder UNC-Pfaden befinden, wird Kopieren/Löschen statt Verschieben durchgeführt.

FileCopyDir, FileCopy, FileMove, FileDelete, Datei-Schleife, FileSelectFolder, SplitPath

Beispiele

Verschiebt ein Verzeichnis auf ein anderes Laufwerk.

FileMoveDir, C:\Mein Ordner, D:\Mein Ordner

Führt eine einfache Umbenennung durch.

FileMoveDir, C:\Mein Ordner, C:\Mein Ordner (umbenannt), R

Verzeichnisse können mittels Umbenennung an einen anderen Ort verschoben werden, solange sie sich auf demselben Datenträger befinden.

FileMoveDir, C:\Mein Ordner, C:\Neuer Standort\Mein Ordner, R