File.RenameTo(File) 方法

定義

命名空間:

Java.IO

組件:

Mono.Android.dll

重新命名這個抽象路徑名稱所表示的檔案。

[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

參數

dest

File

具名檔案的新抽象路徑名稱

傳回

Boolean

true 如果 且只有在重新命名成功時，才會成功; false 否則

屬性

RegisterAttribute

備註

重新命名這個抽象路徑名稱所表示的檔案。

許多失敗都是可能的。 某些更可能失敗的包括： <包含來源和目的地路徑的目錄需要ul><li>Write 許可權。 <這兩個路徑的所有父系都需要 li>Search 許可權。 <li>這兩個路徑都在相同的裝入點上。 在 Android 上，應用程式在嘗試在內部記憶體與 SD 記憶卡之間複製時，最有可能達到此限制。 </ul>

應該一律檢查傳回值，以確保重新命名作業成功。

請注意，類別 java.nio.file.Files 會 java.nio.file.Files#move move 定義方法，以與平台無關的方式移動或重新命名檔案。

的 java.io.File.renameTo(java.io.File)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。