System.SysUtils.RenameFile

• Übergeordnet: System.SysUtils

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

• System.SysUtils.DeleteFile

• System.Rename

• System.SysUtils.TSymLinkRec

• Unterstützung der Dateiein- und -ausgabe

Codebeispiele

• ExtractFileName (C++)
• ExtractFileName (Delphi)