System.SysUtils.RenameFile

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function RenameFile(const OldName, NewName: string): Boolean;

C++

extern DELPHI_PACKAGE bool __fastcall RenameFile(const System::UnicodeString OldName, const System::UnicodeString NewName);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Beschreibung

Ändert den Namen einer Datei.

RenameFile versucht, den Namen der in OldFile angegebenen Datei in NewFile zu ändern. Bei Erfolgt gibt RenameFile True zurück. Kann RenameFile die Datei nicht umbenennen (weil die Anwendung beispielsweise keine entsprechende Berechtigung besitzt), wird False zurückgegeben.

Hinweis: Wenn der Parameter OldName eine symbolische Verknüpfung ist, wird die Methode für die Zieldatei ausgeführt.

Hinweis: Wenn NewFile den Namen einer vorhandenen Datei angibt,verhält sich RenameFile unter Windows anders als unter Macintosh. Unter Windows schlägt die Umbenennung fehl.

Siehe auch

Codebeispiele