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 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
- 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.separator
del 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.dir
del 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(IntPtr, JniHandleOwnership) |
Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el entorno de ejecución. |
File(String) |
Crea una nueva |
File(String, String) |
Crea una nueva |
File(URI) |
Crea una nueva |
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 |
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 |
ParentFile |
Devuelve el nombre de la ruta de acceso abstracta del elemento primario de este nombre de ruta de acceso abstracto, o |
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 |
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() |
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. |