File Класс

Определение

Пространство имен:: Java.IO

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

[Android.Runtime.Register("java/io/File", DoNotGenerateAcw=true)]
public class File : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable

[<Android.Runtime.Register("java/io/File", DoNotGenerateAcw=true)>]
type File = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComparable

Наследование: Object

JavaObject

Object
File

Атрибуты: RegisterAttribute

Реализации: IJavaObject IJavaPeerable ISerializable IComparable IDisposable

Пользовательские интерфейсы и операционные системы используют строки< em pathname, зависящие от ><системы, или em>, для имен файлов и каталогов. Этот класс представляет абстрактное, системное представление иерархических имен путей. У <абстрактного>пути</em> есть два компонента:

olli Необязательный системный префикс/em строка, например описатель диска и & nbsp; для корневого каталога UNIX или & nbsp; для имени пути Microsoft Windows UNC и li Последовательность нулевых или более строковых имен или em. </Пр>

Имя в абстрактном пути может быть именем каталога или, в случае Microsoft Windows UNC pathnames, имя узла. Каждое последующее имя в абстрактном имени пути обозначает каталог; Фамилию можно указать как каталог, так и файл. Имя <абстрактного пути em>пустое< или em> не имеет префикса и пустой последовательности имен.

Преобразование строки имени пути в абстрактное имя пути или из абстрактного имени пути по сути зависит от системы. Если абстрактное имя пути преобразуется в строку имени пути, каждое имя отделяется от следующей копией символа или em< разделителя em>по умолчанию<.> Символ разделителя имен по умолчанию определяется системным свойством file.separatorи доступен в общедоступных статических полях {@link #separator} и {@link #separatorChar} этом классе. При преобразовании строки пути в абстрактное имя пути имена в ней могут быть разделены символом разделителя имен по умолчанию или любым другим символом разделителя имен, поддерживаемым базовой системой.

Имя пути, независимо от того, является ли абстрактная или строковая форма, может быть либо em absolute/em<, либо >относительным</em><.><> Абсолютное имя пути завершено в том, что никакие другие сведения не требуются, чтобы найти файл, который он обозначает. Относительный путь, напротив, должен быть интерпретирован с точки зрения информации, взятой из другого имени пути. По умолчанию классы в пакете java.io всегда разрешают относительные имена путей к текущему каталогу пользователя. Этот каталог называется системным свойством user.dirи обычно является каталогом, в котором была вызвана Java виртуальная машина.

< >Родительский <или em> абстрактного имени пути может быть получен путем вызова #getParent метода этого класса и состоит из префикса имени пути и каждого имени в последовательности имен пути, за исключением последнего. Абсолютный путь каждого каталога является предком любого File объекта с абсолютным абстрактным именем пути, которое начинается с абсолютного имени пути каталога. Например, каталог, обозначаемый абстрактным именем пути "/usr" , является предком каталога, обозначаемого именем "/usr/local/bin"пути.

Концепция префикса используется для обработки корневых каталогов на платформах UNIX, а также описателей дисков, корневых каталогов и имен путей UNC на платформах Microsoft Windows следующим образом:

<Ул>

<li> для платформ UNIX префикс абсолютного имени пути всегда "/". Относительные имена путей не имеют префикса. Абстрактное имя пути, обозначающее корневой каталог, имеет префикс "/" и пустую последовательность имен.

<li> Для платформ Microsoft Windows префикс имени пути, содержащего описатель диска, состоит из буквы диска, за которой следует ":" и, возможно, следует, "\\" если имя пути является абсолютным. Префикс имени UNC-пути "\\\\": имя узла и имя общей папки являются первыми двумя именами в последовательности имен. Относительное имя пути, которое не указывает диск, не имеет префикса.

</ul>

Экземпляры этого класса могут или не могут указывать фактический объект файловой системы, например файл или каталог. Если он обозначает такой объект, этот объект находится в секции. Секция — это часть хранилища операционной системы для файловой системы. Одно устройство хранения (например, физический диск, флэш-память, CD-ROM) может содержать несколько секций. Объект, если он есть, будет находиться в разделе "partName">, именованном некоторым предком абсолютной формы этого имени пути.

Файловая система может реализовать ограничения для определенных операций с фактическим объектом файловой системы, например чтением, записью и выполнением. Эти ограничения совместно называются разрешениями доступа. Файловая система может иметь несколько наборов разрешений доступа для одного объекта. Например, один набор может применяться к владельцу объекта, а другой может применяться ко всем другим пользователям. Разрешения доступа к объекту могут привести к сбою некоторых методов в этом классе.

Экземпляры File класса неизменяемы. То есть после создания абстрактное имя пути, представленное File объектом, никогда не изменится.

<Взаимодействие h3>с пакетомjava.nio.file</h3>

Пакет <c> java.nio.file</c> определяет интерфейсы и классы для виртуальной машины Java для доступа к файлам, атрибутам файлов и файловых системам. Этот API может использоваться для преодоления многих ограничений java.io.File класса. Метод #toPath toPath можно использовать для получения, Path использующего абстрактный путь, представленный File объектом для поиска файла. Результат Path может использоваться с java.nio.file.Files классом, чтобы обеспечить более эффективный и широкий доступ к дополнительным операциям файлов, атрибутам файлов и исключениям ввода-вывода, чтобы помочь диагностировать ошибки при сбое операции в файле.

Строки Android преобразуются в последовательности байтов UTF-8 при отправке имен файлов в операционную систему, а последовательности байтов, возвращаемые операционной системой (из различных list методов), преобразуются в строки, декодируя их как последовательности байтов UTF-8.

Добавлено в JDK1.0.

Java документации по java.io.File.

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Конструкторы

Имя.	Описание
File(File, String)	Создает новый `File` экземпляр из родительского абстрактного имени пути и дочерней строки пути.
File(IntPtr, JniHandleOwnership)	Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения.
File(String, String)	Создает новый `File` экземпляр из строки имени родительского пути и дочерней строки пути.
File(String)	Создает новый `File` экземпляр, преобразовав строку имени пути в абстрактное имя пути.
File(URI)	Создает новый `File` экземпляр, преобразовав заданный `file:` URI в абстрактное имя пути.

Свойства

Имя.	Описание
AbsoluteFile	Возвращает абсолютную форму этого абстрактного имени пути.
AbsolutePath	Возвращает абсолютный путь к этому файлу.
CanonicalFile	Возвращает каноническую форму этого абстрактного имени пути.
CanonicalPath	Возвращает строку канонического пути этого абстрактного имени пути.
Class	Возвращает класс среды выполнения этого `Object`объекта. (Унаследовано от Object)
FreeSpace	Возвращает количество нераспределенных байтов в секции, именуемой этим абстрактным именем пути.
Handle	Дескриптор базового экземпляра Android. (Унаследовано от Object)
IsAbsolute	Проверяет, является ли этот абстрактный путь абсолютным.
IsDirectory	Проверяет, является ли файл, обозначаемый этим абстрактным именем пути, каталогом.
IsFile	Проверяет, является ли файл, обозначаемый этим абстрактным именем пути, обычным файлом.
IsHidden	Проверяет, является ли файл с именем этого абстрактного пути скрытым файлом.
JniIdentityHashCode	Возвращает хэш-код удостоверения, назначенный этому Java одноранговой среде выполнения взаимодействия. (Унаследовано от Object)
JniManagedPeerState	Абстрактное представление имен пути к файлу и каталогу. (Унаследовано от JavaObject)
JniPeerMembers	Абстрактное представление имен пути к файлу и каталогу.
Name	Возвращает имя файла или каталога, обозначаемого этим абстрактным именем пути.
Parent	Возвращает строку имени пути родительского имени этого абстрактного пути или `null` если это имя пути не называет родительский каталог.
ParentFile	Возвращает абстрактное имя пути родительского имени абстрактного пути или `null` если это имя пути не называет родительский каталог.
Path	Преобразует это абстрактное имя пути в строку имени пути.
PathSeparator	Символ разделителя путей, зависящий от системы, представлен в виде строки для удобства.
PathSeparatorChar	Символ разделителя путей, зависимых от системы.
PeerReference	Возвращает ссылку на объект JNI для этого Java однорангового узла. (Унаследовано от Object)
Separator	Символ разделителя имен по умолчанию, зависящий от системы, представлен в виде строки для удобства.
SeparatorChar	Символ разделителя имен по умолчанию, зависимый от системы.
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.
TotalSpace	Возвращает размер секции с именем этого абстрактного пути.
UsableSpace	Возвращает количество байтов, доступных этой виртуальной машине на секции с именем этого абстрактного пути.

Методы

Имя.	Описание
CanExecute()	Проверяет, может ли приложение выполнять файл, обозначаемый этим абстрактным именем пути.
CanRead()	Проверяет, может ли приложение читать файл, обозначаемый этим абстрактным именем пути.
CanWrite()	Проверяет, может ли приложение изменить файл, обозначаемый этим абстрактным именем пути.
Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
CompareTo(File)	Сравнивает два абстрактных имена пути лексографически.
Construct(JniObjectReference, JniObjectReferenceOptions)	Абстрактное представление имен пути к файлу и каталогу. (Унаследовано от JavaObject)
CreateNewFile()	Атомарно создает новый пустой файл с именем этого абстрактного пути, если и только если файл с этим именем еще не существует.
CreateTempFile(String, String, File)	Создает пустой файл в указанном каталоге, используя заданные префиксы и строки суффикса для создания его имени.
CreateTempFile(String, String)	Создает пустой файл в каталоге временных файлов по умолчанию, используя заданный префикс и суффикс для создания его имени.
Delete()	Удаляет файл или каталог, обозначаемый этим абстрактным именем пути.
DeleteOnExit()	Запрашивает удаление файла или каталога, указанного этим абстрактным именем пути, при завершении работы виртуальной машины.
Dispose()	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
Dispose(Boolean)	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
DisposeUnlessReferenced()	Абстрактное представление имен пути к файлу и каталогу. (Унаследовано от JavaObject)
Equals(Object)	Абстрактное представление имен пути к файлу и каталогу. (Унаследовано от JavaObject)
Equals(Object)	Указывает, равен ли другой объект этому объекту. (Унаследовано от Object)
Exists()	Проверяет, существует ли файл или каталог, обозначаемый этим абстрактным именем пути.
GetHashCode()	Возвращает хэш-значение кода для объекта. (Унаследовано от Object)
JavaFinalize()	Устаревшие. Вызывается сборщиком мусора в объекте, когда сборка мусора определяет, что больше ссылок на объект нет. (Унаследовано от Object)
LastModified()	Возвращает время последнего изменения файла, указанного этим абстрактным именем пути.
Length()	Возвращает длину файла, обозначаемую этим абстрактным именем пути.
List()	Возвращает массив строк, именующих файлы и каталоги в каталоге, обозначаемый этим абстрактным именем пути.
List(IFilenameFilter)	Возвращает массив строк, именующих файлы и каталоги в каталоге, обозначаемый этим абстрактным именем пути, удовлетворяющим указанному фильтру.
ListAsync()	Абстрактное представление имен пути к файлу и каталогу.
ListAsync(IFilenameFilter)	Абстрактное представление имен пути к файлу и каталогу.
ListFiles()	Возвращает массив абстрактных имен пути, обозначающих файлы в каталоге, обозначаемый этим абстрактным именем пути.
ListFiles(IFileFilter)	Возвращает массив абстрактных имен пути, обозначающих файлы и каталоги в каталоге, обозначаемый этим абстрактным именем пути, удовлетворяющим указанному фильтру.
ListFiles(IFilenameFilter)	Возвращает массив абстрактных имен пути, обозначающих файлы и каталоги в каталоге, обозначаемый этим абстрактным именем пути, удовлетворяющим указанному фильтру.
ListFilesAsync()	Абстрактное представление имен пути к файлу и каталогу.
ListFilesAsync(IFileFilter)	Абстрактное представление имен пути к файлу и каталогу.
ListFilesAsync(IFilenameFilter)	Абстрактное представление имен пути к файлу и каталогу.
ListRoots()	Возвращает корни файловой системы.
ListRootsAsync()	Абстрактное представление имен пути к файлу и каталогу.
Mkdir()	Создает каталог с именем этого абстрактного пути.
Mkdirs()	Создает каталог с именем этого абстрактного пути, включая все необходимые, но несуществующие родительские каталоги.
Notify()	Просыпается один поток, ожидающий монитора этого объекта. (Унаследовано от Object)
NotifyAll()	Просыпает все потоки, ожидающие монитора этого объекта. (Унаследовано от Object)
RenameTo(File)	Переименовывает файл, обозначаемый этим абстрактным именем пути.
SetExecutable(Boolean, Boolean)	Задает разрешение на выполнение владельца или всех пользователей для этого абстрактного имени пути.
SetExecutable(Boolean)	Удобный метод задания разрешения на выполнение владельца для этого абстрактного имени пути.
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
SetLastModified(Int64)	Задает время последнего изменения файла или каталога с именем этого абстрактного пути.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Абстрактное представление имен пути к файлу и каталогу. (Унаследовано от JavaObject)
SetReadable(Boolean, Boolean)	Задает разрешение владельца на чтение для этого абстрактного имени пути.
SetReadable(Boolean)	Удобный метод задания разрешения владельца на чтение для этого абстрактного имени пути.
SetReadOnly()	Помечает файл или каталог с именем этого абстрактного пути, чтобы разрешены только операции чтения.
SetWritable(Boolean, Boolean)	Задает разрешение на запись владельца или всех пользователей для этого абстрактного имени пути.
SetWritable(Boolean)	Удобный метод задания разрешения на запись владельца для этого абстрактного имени пути.
ToArray<T>()	Создает управляемый массив из этого Java оболочки массива. (Унаследовано от Object)
ToPath()	`Path java.nio.file.Path` Возвращает объект, созданный из этого абстрактного пути.
ToString()	Возвращает строковое представление объекта. (Унаследовано от Object)
ToURI()	Создает универсальный код ресурса (URI), представляющий это абстрактное `file:` имя пути.
ToURL()	Устаревшие. Преобразует это абстрактное имя пути в `file:` URL-адрес.
UnregisterFromRuntime()	Отменяет регистрацию этого Java однорангового узла из среды выполнения взаимодействия. (Унаследовано от Object)
Wait()	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, путем <><уведомления/>em или <эм>прерванного</em.> (Унаследовано от Object)
Wait(Int64, Int32)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)
Wait(Int64)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)

Явные реализации интерфейса

Имя.	Описание
IComparable.CompareTo(Object)	Абстрактное представление имен пути к файлу и каталогу.
IJavaPeerable.Disposed()	Абстрактное представление имен пути к файлу и каталогу. (Унаследовано от JavaObject)
IJavaPeerable.Finalized()	Абстрактное представление имен пути к файлу и каталогу. (Унаследовано от JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Абстрактное представление имен пути к файлу и каталогу. (Унаследовано от JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Абстрактное представление имен пути к файлу и каталогу. (Унаследовано от JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Абстрактное представление имен пути к файлу и каталогу. (Унаследовано от JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Абстрактное представление имен пути к файлу и каталогу. (Унаследовано от JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Абстрактное представление имен пути к файлу и каталогу.

Методы расширения

Имя.	Описание
GetJniTypeName(IJavaPeerable)	Возвращает имя JNI типа экземпляра `self`.
JavaAs<TResult>(IJavaPeerable)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.
JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Абстрактное представление имен пути к файлу и каталогу.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.

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