RenameFile()

Syntax

Ergebnis = RenameFile(AlterDateiName$, NeuerDateiName$)

Nennt die alte Datei in die neue Datei um. Ist 'Ergebnis' gleich 0, ist das Umbenennen fehlgeschlagen.

Es ist auch möglich, Verzeichnisnamen umzubenennen. Verwenden Sie dann einfach den entsprechenden Pfad mit Verzeichnisnamen als Parameter.

Beispiel:

  RenameFile("C:\Temp\Test.txt", "C:\Temp\TestNew.txt")    ; umbenennen der Test Datei im Temp Verzeichnis
  RenameFile("C:\Temp\", "C:\TempNew\")                    ; umbenennen des Temp Verzeichnisses selbst

Durch Angabe zweier unterschiedlicher Verzeichnisse (und sogar Laufwerke) als Parameter ist es möglich, mit diesem Befehl eine Datei auch 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

Unterstützte OS

Alle