RenameFile()

Syntax

Ergebnis = RenameFile(AlterDateiname$, NeuerDateiname$)

Benennt die alte Datei in die neue Datei um.

Parameter

AlterDateiname$	Der alte Name der Datei.
NeuerDateiname$	Der neue Name der Datei.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn die Operation erfolgreich war, und Null bei einem Fehler.

Anmerkungen

Der alte und der neue Dateiname müssen sich nicht im gleichen Verzeichnis befinden. Damit kann diese Funktion auch für das Verschieben einer Datei in ein anderes Verzeichnis verwendet werden. Diese Funktion kann auch verwendet werden, um Verzeichnisse umzubenennen/zu verschieben.

Beispiel

  If RenameFile("C:\test.txt", "D:\temp\test_backup.txt")   
    Debug "Verschieben und Umbenennen erfolgreich."      ; Verschieben der Datei in ein anderes Verzeichnis und Umbenennen erfolgreich
  Else 
    Debug "Verschieben und Umbenennen fehlgeschlagen."   ; Verschieben und Umbenennen fehlgeschlagen, z.B. wegen nicht gefundener Quelldatei
  EndIf

Siehe auch

CopyFile(), DeleteFile(), CreateFile(), CopyDirectory()

Unterstützte OS

Alle