Freigeben über


File.RenameTo(File) Methode

Definition

Benennt die Datei um, die durch diesen abstrakten Pfadnamen gekennzeichnet ist.

[Android.Runtime.Register("renameTo", "(Ljava/io/File;)Z", "GetRenameTo_Ljava_io_File_Handler")]
public virtual bool RenameTo (Java.IO.File dest);
[<Android.Runtime.Register("renameTo", "(Ljava/io/File;)Z", "GetRenameTo_Ljava_io_File_Handler")>]
abstract member RenameTo : Java.IO.File -> bool
override this.RenameTo : Java.IO.File -> bool

Parameter

dest
File

Der neue abstrakte Pfadname für die benannte Datei

Gibt zurück

true wenn und nur, wenn die Umbenennung erfolgreich war; false sonst

Attribute

Hinweise

Benennt die Datei um, die durch diesen abstrakten Pfadnamen gekennzeichnet ist.

Viele Fehler sind möglich. Einige der wahrscheinlicheren Fehler sind: <ul><li>Write-Berechtigung ist für die Verzeichnisse erforderlich, die sowohl die Quell- als auch die Zielpfade enthalten. <li>Search-Berechtigung ist für alle übergeordneten Elemente beider Pfade erforderlich. <li>Beide Pfade befinden sich auf demselben Mount point. Unter Android treffen Anwendungen diese Einschränkung höchstwahrscheinlich, wenn Sie versuchen, zwischen internem Speicher und einer SD-Karte zu kopieren. </ul>

Der Rückgabewert sollte immer überprüft werden, um sicherzustellen, dass der Umbenennungsvorgang erfolgreich war.

Beachten Sie, dass die java.nio.file.Files Klasse die java.nio.file.Files#move move Methode definiert, um eine Datei auf plattformunabhängige Weise zu verschieben oder umzubenennen.

Java-Dokumentation für java.io.File.renameTo(java.io.File).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: