File Clase

Definición

Representación abstracta de los 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.Interop.IJavaPeerable, 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
File
Atributos
Implementaciones

Comentarios

Representación abstracta de los 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 de acceso jerárquicos. >Una <ruta de acceso< abstracta/em> tiene dos componentes:

<ol><li> Una cadena opcional e>prefijo</em> dependiente <del sistema, como un especificador de unidad de disco, "/"  para el directorio raíz de UNIX o "\\\\"  para un nombre de ruta de acceso UNC de Microsoft Windows y <li> Una secuencia de cero o más nombres< em>de cadena</em>. </Ol>

El nombre de un nombre de ruta de acceso abstracto puede ser un nombre de directorio o, en el caso de los nombres de ruta de acceso UNC de Microsoft Windows, un nombre de host. Cada nombre subsiguiente en un nombre pathname abstracto denota un directorio; el apellido puede indicar un directorio o un archivo. >Em <empty</em> abstract pathname no tiene prefijo y una secuencia de nombres vacía.

La conversión de una cadena pathname a o desde un nombre de ruta de acceso abstracta depende inherentemente del sistema. Cuando un nombre de ruta de acceso abstracto se convierte en una cadena pathname, cada nombre se separa de la siguiente mediante una sola copia del carácter< separador em>predeterminado</em>. El carácter separador de nombres 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 de ruta de acceso 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 admitido por el sistema subyacente.

Un nombre de ruta de acceso, ya sea abstracto o en forma de cadena, puede ser em absolute/em> o <em>relative</em>.<>< Un nombre de ruta de acceso absoluto se completa en que no se requiere ninguna otra información para localizar el archivo que indica. Un nombre de ruta de acceso relativo, en cambio, 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 nombres de ruta de acceso relativos en el directorio de usuario actual. La propiedad user.dirdel sistema denomina este directorio y normalmente es 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 absoluta de cada directorio es un antecesor de cualquier File objeto con un nombre de ruta de acceso abstracto absoluto que comienza con el nombre pathname absoluto del directorio. Por ejemplo, el directorio indicado por el nombre de la ruta de acceso "/usr" abstracta es un antecesor del directorio indicado por pathname "/usr/local/bin".

El concepto de prefijo se usa para controlar directorios raíz en plataformas UNIX y especificadores de unidades, 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 ningún 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 las plataformas De Microsoft Windows, el prefijo de un nombre de ruta de acceso que contiene un especificador de unidad consta de la letra ":" de unidad seguida de y posiblemente seguido de "\\" si el nombre de ruta de acceso es absoluto. 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 nombre de ruta de acceso.

Un sistema de archivos puede implementar restricciones para 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 puede aplicarse 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 un 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 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 descodándolas como secuencias de bytes UTF-8.

Se ha agregado en JDK1.0.

Documentación de Java para java.io.File.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código y se usan según los términos descritos en la creative Commons 2.5.

Constructores

File(File, String)

Crea una nueva File instancia a partir de un nombre de ruta de acceso abstracto primario y una cadena de nombre de ruta de acceso secundaria.

File(IntPtr, JniHandleOwnership)

Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el entorno de ejecución.

File(String)

Crea una nueva File instancia convirtiendo la cadena pathname determinada en un nombre de ruta de acceso abstracto.

File(String, String)

Crea una nueva File instancia a partir de una cadena de nombrede ruta de acceso principal y una cadena de nombre de ruta de acceso secundaria.

File(URI)

Crea una nueva File instancia convirtiendo el URI especificado file: en un nombre de ruta de acceso abstracto.

Propiedades

AbsoluteFile

Devuelve la forma absoluta de este nombre de ruta de acceso abstracto.

AbsolutePath

Devuelve la ruta de acceso absoluta de este archivo.

CanonicalFile

Devuelve la forma canónica de este nombre de ruta de acceso abstracto.

CanonicalPath

Devuelve la cadena pathname canónica de este nombre de ruta de acceso abstracto.

Class

Devuelve la clase en tiempo de ejecución de este Objectobjeto .

(Heredado de Object)
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 abstracta es un archivo normal.

IsHidden

Comprueba si el archivo denominado por este nombre de ruta de acceso abstracta es un archivo oculto.

JniIdentityHashCode

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(Heredado de Object)
JniPeerMembers

Representación abstracta de los 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 null si este nombre de ruta de acceso no asigna un nombre a un directorio primario.

ParentFile

Devuelve el nombre de la ruta de acceso abstracta del elemento primario de este nombre de ruta de acceso abstracto, o null si este nombre de ruta de acceso no asigna un nombre a un directorio primario.

Path

Convierte este nombre de ruta de acceso abstracto 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

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(Heredado de Object)
Separator

Carácter separador de nombres 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

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.

CreateNewFile()

Crea de forma atómica un nuevo archivo vacío denominado por este nombre de ruta de acceso abstracto si y solo si aún no existe un archivo con este nombre.

CreateTempFile(String, String)

Crea un archivo vacío en el directorio de archivos temporales predeterminado, con el prefijo y el sufijo especificados para generar su nombre.

CreateTempFile(String, String, File)

Crea un nuevo archivo vacío en el directorio especificado, utilizando las cadenas de prefijo y 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 abstracta se elimine cuando finaliza la máquina virtual.

Dispose()

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(Heredado de Object)
Dispose(Boolean)

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(Heredado de Object)
Equals(Object)

Indica si algún otro objeto es "igual a" este.

(Heredado de Object)
Exists()

Comprueba si el archivo o directorio indicado por este nombre de ruta de acceso abstracto existe.

GetHashCode()

Devuelve un valor de código hash del objeto.

(Heredado de Object)
JavaFinalize()

Llamado por 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 el archivo indicado por este nombre de ruta de acceso abstracta se modificó por última vez.

Length()

Devuelve la longitud del archivo indicado por este nombre de ruta de acceso abstracto.

List()

Devuelve una matriz de cadenas que asignan nombres a los archivos y directorios del directorio indicado por este nombre de ruta de acceso abstracto.

List(IFilenameFilter)

Devuelve una matriz de cadenas que asignan nombres a 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 los nombres de ruta de acceso de archivo y directorio.

ListAsync(IFilenameFilter)

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

ListFiles()

Devuelve una matriz de nombres de ruta de acceso abstractos que denotan los archivos en el directorio indicado por este nombre de ruta de acceso abstracto.

ListFiles(IFileFilter)

Devuelve una matriz de nombres de ruta de acceso abstractos 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 abstractos 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 los nombres de ruta de acceso de archivo y directorio.

ListFilesAsync(IFileFilter)

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

ListFilesAsync(IFilenameFilter)

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

ListRoots()

Devuelve las raíces del sistema de archivos.

ListRootsAsync()

Representación abstracta de los 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 abstracto, 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)

Método de conveniencia para establecer el permiso de ejecución del propietario para este nombre de ruta de acceso abstracto.

SetExecutable(Boolean, Boolean)

Establece el permiso de ejecución del propietario o de todos para este nombre de ruta de acceso abstracto.

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 de ruta de acceso abstracta.

SetReadable(Boolean)

Método de conveniencia para establecer el permiso de lectura del propietario para este nombre de ruta de acceso abstracto.

SetReadable(Boolean, Boolean)

Establece el permiso de lectura de todos o del propietario para este nombre de ruta de acceso abstracto.

SetReadOnly()

Marca el archivo o directorio denominado por este nombre de ruta de acceso abstracto para que solo se permitan las operaciones de lectura.

SetWritable(Boolean)

Método de conveniencia para establecer el permiso de escritura del propietario para este nombre de ruta de acceso abstracto.

SetWritable(Boolean, Boolean)

Establece el permiso de escritura de todos o del propietario para este nombre de ruta de acceso abstracto.

ToArray<T>()

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(Heredado de Object)
ToPath()

Devuelve un Path java.nio.file.Path objeto construido a partir de esta ruta de acceso abstracta.

ToString()

Devuelve una representación de cadena del objeto.

(Heredado de Object)
ToURI()

Construye un file: URI que representa este nombre de ruta de acceso abstracto.

ToURL()
Obsoletos.

Convierte este nombre de ruta de acceso abstracto en una file: dirección URL.

UnregisterFromRuntime()

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(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)

Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <notificado<>/em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real.

(Heredado de Object)
Wait(Int64, Int32)

Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <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

IComparable.CompareTo(Object)

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

IJavaPeerable.Disposed()

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(Heredado de Object)
IJavaPeerable.DisposeUnlessReferenced()

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(Heredado de Object)
IJavaPeerable.Finalized()

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(Heredado de Object)
IJavaPeerable.JniManagedPeerState

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(Heredado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(Heredado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(Heredado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

(Heredado de Object)

Métodos de extensió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 los nombres de ruta de acceso de archivo y directorio.

GetJniTypeName(IJavaPeerable)

Representación abstracta de los nombres de ruta de acceso de archivo y directorio.

Se aplica a