File Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representación abstracta de nombres de ruta de acceso de archivo y directorio.
[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
- Herencia
- Atributos
- Implementaciones
Comentarios
Representación abstracta de nombres de ruta de acceso de archivo y directorio.
Las interfaces de usuario y los sistemas operativos usan cadenas de nombrede ruta de acceso dependientes <><del sistema/em> para asignar nombres a archivos y directorios. Esta clase presenta una vista abstracta independiente del sistema de los nombres de ruta jerárquicos. Una <ruta de acceso>< abstracta em>tiene dos componentes:
El nombre del nombre de una ruta de acceso abstracta puede ser un nombre de directorio o, en el caso de Microsoft Windows nombres de ruta de acceso UNC, un nombre de host. Cada nombre posterior de un nombre de ruta abstracta denota un directorio; el apellido puede indicar un directorio o un archivo. El nombre de ruta de <acceso abstracta em>empty</em> no tiene prefijo y una secuencia de nombres vacía.
La conversión de una cadena pathname a o desde un pathname abstracto depende inherentemente del sistema. Cuando un nombre de ruta de acceso abstracto se convierte en una cadena pathname, cada nombre se separa del siguiente mediante una sola copia del carácter< separador em>predeterminado</em>. El carácter separador de nombre predeterminado se define mediante la propiedad file.separatordel sistema y está disponible en los campos {@link #separator} estáticos públicos y {@link #separatorChar} de esta clase. Cuando una cadena pathname se convierte en un nombre pathname abstracto, los nombres dentro de él pueden estar separados por el carácter separador de nombres predeterminado o por cualquier otro carácter separador de nombres que admita el sistema subyacente.
Un pathname, ya sea abstracto o en forma de cadena, puede ser <em>absolute</em> o <em>relative</em>. Se ha completado un pathname absoluto en que no se requiere ninguna otra información para localizar el archivo que denota. Un pathname relativo, por el contrario, debe interpretarse en términos de información tomada de algún otro nombre de ruta de acceso. De forma predeterminada, las clases del java.io paquete siempre resuelven los nombres de ruta de acceso relativos en el directorio de usuario actual. La propiedad user.dirdel sistema denomina este directorio y suele ser el directorio en el que se invocó la máquina virtual Java.
El <em>parent</em> de un nombre de ruta de acceso abstracto se puede obtener invocando el #getParent método de esta clase y consta del prefijo pathname y de cada nombre en la secuencia de nombres pathname, excepto para la última. El nombre de ruta de acceso absoluto de cada directorio es un antecesor de cualquier File objeto con un nombre pathname abstracto absoluto que comienza con el nombre pathname absoluto del directorio. Por ejemplo, el directorio indicado por el nombre "/usr" de ruta abstracta es un antecesor del directorio indicado por el nombre pathname "/usr/local/bin".
El concepto de prefijo se usa para controlar directorios raíz en plataformas UNIX y especificadores de unidad, directorios raíz y nombres de ruta de acceso UNC en plataformas Microsoft Windows, como se indica a continuación:
<ul>
<li> Para las plataformas UNIX, el prefijo de un nombre de ruta de acceso absoluto siempre "/"es . Los nombres de ruta de acceso relativos no tienen prefijo. El nombre de ruta de acceso abstracto que indica que el directorio raíz tiene el prefijo "/" y una secuencia de nombres vacía.
<li> Para Microsoft Windows plataformas, el prefijo de un pathname que contiene un especificador de unidad consta de la letra de unidad seguida ":" de y posiblemente seguido de "\\" si pathname es absoluta. El prefijo de un nombre de ruta de acceso UNC es "\\\\"; el nombre de host y el nombre del recurso compartido son los dos primeros nombres de la secuencia de nombres. Un nombre de ruta de acceso relativo que no especifica una unidad no tiene ningún prefijo.
</ul>
Las instancias de esta clase pueden indicar o no un objeto real del sistema de archivos, como un archivo o un directorio. Si denota este tipo de objeto, ese objeto reside en una partición. Una partición es una parte específica del sistema operativo del almacenamiento para un sistema de archivos. Un único dispositivo de almacenamiento (por ejemplo, una unidad de disco física, memoria flash, CD-ROM) puede contener varias particiones. El objeto, si existe, residirá en la partición "partName"> denominada por algún antecesor de la forma absoluta de este pathname.
Un sistema de archivos puede implementar restricciones a determinadas operaciones en el objeto real del sistema de archivos, como leer, escribir y ejecutar. Estas restricciones se conocen colectivamente como permisos de acceso. El sistema de archivos puede tener varios conjuntos de permisos de acceso en un solo objeto. Por ejemplo, un conjunto se puede aplicar al propietario del objeto y otro puede aplicarse a todos los demás usuarios. Los permisos de acceso en un objeto pueden provocar un error en algunos métodos de esta clase.
Las instancias de la File clase son inmutables; es decir, una vez creada, el nombre de ruta de acceso abstracto representado por un File objeto nunca cambiará.
<h3>Interoperabilidad con java.nio.file package</h3>
El <paquete c> java.nio.file</c> define interfaces y clases para que la máquina virtual Java acceda a archivos, atributos de archivo y sistemas de archivos. Esta API se puede usar para superar muchas de las limitaciones de la java.io.File clase . El #toPath toPath método se puede usar para obtener un Path objeto que usa la ruta de acceso abstracta representada por un File objeto para buscar un archivo. El resultado Path se puede usar con la java.nio.file.Files clase para proporcionar acceso más eficaz y extenso a operaciones de archivo adicionales, atributos de archivo y excepciones de E/S para ayudar a diagnosticar errores cuando se produce un error en una operación en un archivo.
En las cadenas de Android se convierten en secuencias de bytes UTF-8 al enviar nombres de archivo al sistema operativo y las secuencias de bytes devueltas por el sistema operativo (de los distintos list métodos) se convierten en cadenas descodificarlas como secuencias de bytes UTF-8.
Agregado en JDK1.0.
Java documentación para java.io.File.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Constructores
| Nombre | Description |
|---|---|
| File(File, String) |
Crea una nueva |
| File(IntPtr, JniHandleOwnership) |
Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución. |
| File(String, String) |
Crea una nueva |
| File(String) |
Crea una nueva |
| File(URI) |
Crea una nueva |
Propiedades
| Nombre | Description |
|---|---|
| AbsoluteFile |
Devuelve la forma absoluta de este nombre de ruta de acceso abstracta. |
| AbsolutePath |
Devuelve la ruta de acceso absoluta de este archivo. |
| CanonicalFile |
Devuelve la forma canónica de este nombre de ruta de acceso abstracta. |
| CanonicalPath |
Devuelve la cadena pathname canónica de este pathname abstracto. |
| Class |
Devuelve la clase en tiempo de ejecución de este |
| FreeSpace |
Devuelve el número de bytes sin asignar en la partición denominada por este nombre de ruta de acceso abstracta. |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| IsAbsolute |
Comprueba si este nombre de ruta de acceso abstracto es absoluto. |
| IsDirectory |
Comprueba si el archivo indicado por este nombre de ruta de acceso abstracto es un directorio. |
| IsFile |
Comprueba si el archivo indicado por este nombre de ruta de acceso abstracto es un archivo normal. |
| IsHidden |
Comprueba si el archivo denominado por este nombre de ruta de acceso abstracta es un archivo oculto. |
| JniIdentityHashCode |
Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| JniManagedPeerState |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. (Heredado de JavaObject) |
| JniPeerMembers |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. |
| Name |
Devuelve el nombre del archivo o directorio indicado por este nombre de ruta de acceso abstracto. |
| Parent |
Devuelve la cadena pathname del elemento primario de este nombre de ruta de acceso abstracto, o |
| ParentFile |
Devuelve el nombre de ruta de acceso abstracto del elemento primario de este nombre de ruta de acceso abstracto, o |
| Path |
Convierte este nombre de ruta abstracta en una cadena pathname. |
| PathSeparator |
Carácter separador de ruta de acceso dependiente del sistema, representado como una cadena para mayor comodidad. |
| PathSeparatorChar |
Carácter separador de ruta de acceso dependiente del sistema. |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| Separator |
Carácter separador de nombre predeterminado dependiente del sistema, representado como una cadena para mayor comodidad. |
| SeparatorChar |
Carácter separador de nombres predeterminado dependiente del sistema. |
| ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| TotalSpace |
Devuelve el tamaño de la partición denominada por este nombre de ruta de acceso abstracta. |
| UsableSpace |
Devuelve el número de bytes disponibles para esta máquina virtual en la partición denominada por este nombre de ruta de acceso abstracta. |
Métodos
| Nombre | Description |
|---|---|
| CanExecute() |
Comprueba si la aplicación puede ejecutar el archivo indicado por este nombre de ruta de acceso abstracto. |
| CanRead() |
Comprueba si la aplicación puede leer el archivo indicado por este nombre de ruta de acceso abstracto. |
| CanWrite() |
Comprueba si la aplicación puede modificar el archivo indicado por este nombre de ruta de acceso abstracto. |
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
| CompareTo(File) |
Compara dos nombres de ruta de acceso abstractos lexicográficamente. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. (Heredado de JavaObject) |
| CreateNewFile() |
Crea de forma atómica un nuevo archivo vacío denominado por este nombre de ruta de acceso abstracta si y solo si aún no existe un archivo con este nombre. |
| CreateTempFile(String, String, File) |
Crea un nuevo archivo vacío en el directorio especificado, con el prefijo y las cadenas de sufijo especificados para generar su nombre. |
| CreateTempFile(String, String) |
Crea un archivo vacío en el directorio de archivos temporales predeterminado, utilizando el prefijo y el sufijo especificados para generar su nombre. |
| Delete() |
Elimina el archivo o directorio indicado por este nombre de ruta de acceso abstracto. |
| DeleteOnExit() |
Solicita que el archivo o directorio indicado por este nombre de ruta de acceso abstracto se elimine cuando finaliza la máquina virtual. |
| Dispose() |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| Dispose(Boolean) |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| DisposeUnlessReferenced() |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. (Heredado de JavaObject) |
| Equals(Object) |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. (Heredado de JavaObject) |
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| Exists() |
Comprueba si existe el archivo o directorio indicado por este nombre de ruta de acceso abstracto. |
| GetHashCode() |
Devuelve un valor de código hash para el objeto . (Heredado de Object) |
| JavaFinalize() |
Obsoletos.
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| LastModified() |
Devuelve la hora en que se modificó por última vez el archivo indicado por este nombre de ruta de acceso abstracto. |
| Length() |
Devuelve la longitud del archivo indicado por este nombre de ruta de acceso abstracto. |
| List() |
Devuelve una matriz de cadenas que denominan los archivos y directorios del directorio indicado por este nombre de ruta de acceso abstracto. |
| List(IFilenameFilter) |
Devuelve una matriz de cadenas que denominan los archivos y directorios del directorio indicado por este nombre de ruta de acceso abstracto que satisface el filtro especificado. |
| ListAsync() |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. |
| ListAsync(IFilenameFilter) |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. |
| ListFiles() |
Devuelve una matriz de nombres de ruta de acceso abstractas que indican los archivos del directorio indicado por este nombre de ruta de acceso abstracto. |
| ListFiles(IFileFilter) |
Devuelve una matriz de nombres de ruta de acceso abstractas que indican los archivos y directorios del directorio indicado por este nombre de ruta de acceso abstracto que satisface el filtro especificado. |
| ListFiles(IFilenameFilter) |
Devuelve una matriz de nombres de ruta de acceso abstractas que indican los archivos y directorios del directorio indicado por este nombre de ruta de acceso abstracto que satisface el filtro especificado. |
| ListFilesAsync() |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. |
| ListFilesAsync(IFileFilter) |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. |
| ListFilesAsync(IFilenameFilter) |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. |
| ListRoots() |
Devuelve las raíces del sistema de archivos. |
| ListRootsAsync() |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. |
| Mkdir() |
Crea el directorio denominado por este nombre de ruta de acceso abstracto. |
| Mkdirs() |
Crea el directorio denominado por este nombre de ruta de acceso abstracta, incluidos los directorios primarios necesarios pero inexistentes. |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| RenameTo(File) |
Cambia el nombre del archivo indicado por este nombre de ruta de acceso abstracto. |
| SetExecutable(Boolean, Boolean) |
Establece el permiso de ejecución de todos o del propietario para este nombre de ruta de acceso abstracto. |
| SetExecutable(Boolean) |
Método de conveniencia para establecer el permiso de ejecución del propietario para este nombre de ruta de acceso abstracta. |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetLastModified(Int64) |
Establece la hora de última modificación del archivo o directorio denominado por este nombre pathname abstracto. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. (Heredado de JavaObject) |
| SetReadable(Boolean, Boolean) |
Establece el permiso de lectura del propietario o de todos para este nombre de ruta de acceso abstracto. |
| SetReadable(Boolean) |
Método de conveniencia para establecer el permiso de lectura del propietario para este nombre de ruta de acceso abstracta. |
| SetReadOnly() |
Marca el archivo o directorio denominado por este nombre de ruta de acceso abstracto para que solo se permitan operaciones de lectura. |
| SetWritable(Boolean, Boolean) |
Establece el permiso de escritura de todos o del propietario para este nombre de ruta de acceso abstracto. |
| SetWritable(Boolean) |
Método de conveniencia para establecer el permiso de escritura del propietario para este nombre de ruta de acceso abstracta. |
| ToArray<T>() |
Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object) |
| ToPath() |
Devuelve un |
| ToString() |
Devuelve una representación de cadena del objeto . (Heredado de Object) |
| ToURI() |
Construye un |
| ToURL() |
Obsoletos.
Convierte este nombre de ruta de acceso abstracto en una |
| UnregisterFromRuntime() |
Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| Wait() |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IComparable.CompareTo(Object) |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. |
| IJavaPeerable.Disposed() |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. (Heredado de JavaObject) |
| IJavaPeerable.Finalized() |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. (Heredado de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. (Heredado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. (Heredado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. (Heredado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. (Heredado de JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. |
Métodos de extensión
| Nombre | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
Representación abstracta de nombres de ruta de acceso de archivo y directorio. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |