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.