Sprache

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 andernfalls

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 von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: