Поделиться через


File.RenameTo(File) Метод

Определение

Переименовывает файл, обозначаемый этим абстрактным именем пути.

[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

Новое абстрактное имя пути для именованного файла

Возвращаемое значение

true значение if и только в том случае, если переименование выполнено успешно; false иначе

Атрибуты

Комментарии

Переименовывает файл, обозначаемый этим абстрактным именем пути.

Возможны многие сбои. Некоторые из наиболее вероятных сбоев включают в себя: <разрешение на запись ul><li>требуется для каталогов, содержащих пути к источнику и назначению. <разрешение li>Search требуется для всех родителей обоих путей. <li>Обе пути будут находиться в одной точке подключения. В Android приложения, скорее всего, ударят по этому ограничению при попытке копирования между внутренним хранилищем и SD-картой. </ul>

Возвращаемое значение всегда должно проверяться, чтобы убедиться, что операция переименования выполнена успешно.

Обратите внимание, что java.nio.file.Files класс определяет java.nio.file.Files#move move метод для перемещения или переименования файла независимо от платформы.

Документация по Java для java.io.File.renameTo(java.io.File).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Применяется к