Datei umbenennen

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Dateien bearbeiten

Sie können Dateinamen mit der Funktion System.SysUtils.RenameFile umbenennen:

Delphi:
 function RenameFile(const OldFileName, NewFileName: string): Boolean;
C++:
extern DELPHI_PACKAGE bool __fastcall RenameFile(const System::UnicodeString OldName,
    const System::UnicodeString NewName);

RenameFile ändert den als OldFileName angegebenen Dateinamen in den neuen Namen NewFileName. Wurde die Operation erfolgreich durchgeführt, gibt RenameFile den Wert True zurück. Konnte die Datei nicht umbenannt werden, weil beispielsweise bereits eine Datei mit dem Namen NewFileName vorhanden ist, gibt die Funktion False zurück. Beispiel:

Delphi:
 if not RenameFile('OLDNAME.TXT','NEWNAME.TXT') then
   ErrorMsg('Error renaming file!');
C++:
if (!RenameFile("OLDNAME.TXT","NEWNAME.TXT"))
    ErrorMsg("Error renaming file!");

Sie können Dateien mit RenameFile nicht über Laufwerke hinweg umbenennen (verschieben). Zu diesem Zweck müssen Sie zunächst die Datei kopieren und dann die alte Dateiversion löschen.

Anmerkung: RenameFile ist in der RTL (Laufzeitbibliothek) ein Wrapper für die Windows-API-Funktion MoveFile. Daher arbeitet auch MoveFile nicht über Laufwerke hinweg.

Siehe auch