File Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire.
[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- Héritage
- Attributs
- Implémente
Remarques
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire.
Les interfaces utilisateur et les systèmes d’exploitation utilisent des chaînes em pathname dépendantes< du ><système/em> pour nommer des fichiers et des répertoires. Cette classe présente une vue abstraite indépendante du système des chemins d’accès hiérarchiques. Un <pathname>/em abstrait em< a deux>composants :
Le prénom d’un chemin d’accès abstrait peut être un nom de répertoire ou, dans le cas de Microsoft Windows noms de chemin UNC, un nom d’hôte. Chaque nom suivant dans un chemin d’accès abstrait désigne un répertoire ; le nom peut indiquer un répertoire ou un fichier. Le <chemin d’accès abstrait em>vide</em> n’a pas de préfixe et une séquence de noms vide.
La conversion d’une chaîne pathname vers ou à partir d’un chemin d’accès abstrait dépend intrinsèquement du système. Lorsqu’un chemin d’accès abstrait est converti en chaîne de chemin d’accès, chaque nom est séparé de la suivante par une seule copie du caractère< de séparateur em>par défaut</ em>. Le caractère de séparation de nom par défaut est défini par la propriété file.separatorsystème et est mis à disposition dans les champs {@link #separator} statiques publics et {@link #separatorChar} de cette classe. Lorsqu’une chaîne pathname est convertie en chemin d’accès abstrait, les noms qu’il contient peuvent être séparés par le caractère de séparation de nom par défaut ou par tout autre caractère de séparateur de noms pris en charge par le système sous-jacent.
Un nom de chemin, qu’il s’agisse d’un chemin d’accès abstrait ou sous forme de chaîne, peut être em absolute/em< ou >em<relative>/em<.><> Un chemin d’accès absolu est terminé, car aucune autre information n’est requise pour localiser le fichier qu’il désigne. Un chemin d’accès relatif, en revanche, doit être interprété en termes d’informations provenant d’un autre nom de chemin. Par défaut, les classes du java.io package résolvent toujours les noms de chemin d’accès relatifs par rapport au répertoire utilisateur actuel. Ce répertoire est nommé par la propriété user.dirsystème et est généralement le répertoire dans lequel la machine virtuelle Java a été appelée.
Le <parent> em/em< d’un chemin d’accès abstrait peut être obtenu en appelant la > méthode de cette classe et se compose du préfixe du nom de chemin et de chaque nom dans la séquence de noms du chemin d’accès, à l’exception#getParentdu dernier. Chaque nom de chemin d’accès absolu de chaque répertoire est un ancêtre de n’importe quel File objet avec un chemin d’accès abstrait absolu qui commence par le chemin d’accès absolu du répertoire. Par exemple, le répertoire indiqué par le chemin d’accès "/usr" abstrait est un ancêtre du répertoire indiqué par le chemin d’accès "/usr/local/bin".
Le concept de préfixe est utilisé pour gérer les répertoires racines sur les plateformes UNIX et les spécificateurs de lecteurs, les répertoires racines et les noms de chemins UNC sur les plateformes Microsoft Windows, comme suit :
<ul>
<li> Pour les plateformes UNIX, le préfixe d’un chemin d’accès absolu est toujours "/". Les chemins d’accès relatifs n’ont aucun préfixe. Le nom de chemin d’accès abstrait indiquant le répertoire racine a le préfixe "/" et une séquence de noms vide.
<Li> For Microsoft Windows plateformes, le préfixe d’un chemin d’accès qui contient un spécificateur de lecteur se compose de la lettre de lecteur suivie ":" et éventuellement suivie par "\\" si le chemin d’accès est absolu. Le préfixe d’un chemin d’accès UNC est "\\\\"; le nom d’hôte et le nom de partage sont les deux premiers noms dans la séquence de noms. Un chemin d’accès relatif qui ne spécifie pas de lecteur n’a pas de préfixe.
</ul>
Les instances de cette classe peuvent ou non désigner un objet système de fichiers réel tel qu’un fichier ou un répertoire. S’il désigne un tel objet, cet objet réside dans une partition. Une partition est une partie spécifique au système d’exploitation du stockage pour un système de fichiers. Un seul périphérique de stockage (par exemple, un disque physique, une mémoire flash, CD-ROM) peut contenir plusieurs partitions. L’objet, le cas échéant, réside sur la partition « partName »> nommée par un ancêtre de la forme absolue de ce chemin d’accès.
Un système de fichiers peut implémenter des restrictions à certaines opérations sur l’objet de système de fichiers réel, telles que la lecture, l’écriture et l’exécution. Ces restrictions sont collectivement appelées autorisations d’accès. Le système de fichiers peut avoir plusieurs ensembles d’autorisations d’accès sur un seul objet. Par exemple, un jeu peut s’appliquer au propriétaire de l’objet, et un autre peut s’appliquer à tous les autres utilisateurs. Les autorisations d’accès sur un objet peuvent entraîner l’échec de certaines méthodes de cette classe.
Les instances de la File classe sont immuables ; autrement dit, une fois créées, le chemin d’accès abstrait représenté par un File objet ne changera jamais.
<Interopérabilité h3>avec java.nio.file package</h3>
Le <package c> java.nio.file</c> définit des interfaces et des classes pour la machine virtuelle Java pour accéder aux fichiers, attributs de fichier et systèmes de fichiers. Cette API peut être utilisée pour surmonter la plupart des limitations de la java.io.File classe. La #toPath toPath méthode peut être utilisée pour obtenir un Path chemin d’accès abstrait représenté par un File objet pour localiser un fichier. Les résultats peuvent Path être utilisés avec la java.nio.file.Files classe pour fournir un accès plus efficace et étendu aux opérations de fichier supplémentaires, aux attributs de fichier et aux exceptions d’E/S pour aider à diagnostiquer les erreurs lorsqu’une opération sur un fichier échoue.
Sur les chaînes Android sont converties en séquences d’octets UTF-8 lors de l’envoi de noms de fichiers au système d’exploitation, et les séquences d’octets retournées par le système d’exploitation (à partir des différentes list méthodes) sont converties en chaînes en les décodant en séquences d’octets UTF-8.
Ajouté dans JDK1.0.
Java documentation pour java.io.File.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
Constructeurs
| Nom | Description |
|---|---|
| File(File, String) |
Crée une instance à partir d’un |
| File(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
| File(String, String) |
Crée une instance à partir d’une |
| File(String) |
Crée une |
| File(URI) |
Crée une |
Propriétés
| Nom | Description |
|---|---|
| AbsoluteFile |
Retourne la forme absolue de ce chemin d’accès abstrait. |
| AbsolutePath |
Retourne le chemin absolu de ce fichier. |
| CanonicalFile |
Retourne la forme canonique de ce chemin d’accès abstrait. |
| CanonicalPath |
Retourne la chaîne de chemin d’accès canonique de ce chemin d’accès abstrait. |
| Class |
Retourne la classe runtime de ce |
| FreeSpace |
Retourne le nombre d’octets non alloués dans la partition nommée par ce nom de chemin d’accès abstrait. |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| IsAbsolute |
Teste si ce chemin d’accès abstrait est absolu. |
| IsDirectory |
Teste si le fichier indiqué par ce chemin d’accès abstrait est un répertoire. |
| IsFile |
Teste si le fichier indiqué par ce chemin d’accès abstrait est un fichier normal. |
| IsHidden |
Teste si le fichier nommé par ce chemin d’accès abstrait est un fichier masqué. |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. (Hérité de JavaObject) |
| JniPeerMembers |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. |
| Name |
Retourne le nom du fichier ou du répertoire indiqué par ce chemin d’accès abstrait. |
| Parent |
Retourne la chaîne pathname du parent de ce chemin d’accès abstrait, ou |
| ParentFile |
Retourne le chemin d’accès abstrait du parent de ce chemin d’accès abstrait, ou |
| Path |
Convertit ce chemin d’accès abstrait en chaîne pathname. |
| PathSeparator |
Caractère séparateur de chemin dépendant du système, représenté sous la forme d’une chaîne à des fins pratiques. |
| PathSeparatorChar |
Caractère séparateur de chemin dépendant du système. |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| Separator |
Caractère de séparateur de noms par défaut dépendant du système, représenté sous forme de chaîne par commodité. |
| SeparatorChar |
Caractère de séparateur de noms par défaut dépendant du système. |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
| TotalSpace |
Retourne la taille de la partition nommée par ce chemin d’accès abstrait. |
| UsableSpace |
Retourne le nombre d’octets disponibles pour cette machine virtuelle sur la partition nommée par ce chemin d’accès abstrait. |
Méthodes
| Nom | Description |
|---|---|
| CanExecute() |
Teste si l’application peut exécuter le fichier indiqué par ce chemin d’accès abstrait. |
| CanRead() |
Teste si l’application peut lire le fichier indiqué par ce chemin d’accès abstrait. |
| CanWrite() |
Teste si l’application peut modifier le fichier indiqué par ce chemin d’accès abstrait. |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| CompareTo(File) |
Compare deux chemins d’accès abstraits lexicographiquement. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. (Hérité de JavaObject) |
| CreateNewFile() |
Crée atomiquement un fichier vide nommé par ce chemin d’accès abstrait si et seulement si un fichier portant ce nom n’existe pas encore. |
| CreateTempFile(String, String, File) |
Crée un fichier vide dans le répertoire spécifié, à l’aide du préfixe et des chaînes de suffixe donnés pour générer son nom. |
| CreateTempFile(String, String) |
Crée un fichier vide dans le répertoire de fichiers temporaires par défaut, à l’aide du préfixe et du suffixe donnés pour générer son nom. |
| Delete() |
Supprime le fichier ou le répertoire indiqué par ce chemin d’accès abstrait. |
| DeleteOnExit() |
Demande que le fichier ou le répertoire indiqué par ce nom de chemin d’accès abstrait soit supprimé lorsque la machine virtuelle se termine. |
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| DisposeUnlessReferenced() |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. (Hérité de JavaObject) |
| Equals(Object) |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. (Hérité de JavaObject) |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| Exists() |
Teste si le fichier ou le répertoire indiqué par ce chemin d’accès abstrait existe. |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| LastModified() |
Retourne l’heure à laquelle le fichier indiqué par ce chemin d’accès abstrait a été modifié pour la dernière fois. |
| Length() |
Retourne la longueur du fichier indiqué par ce chemin d’accès abstrait. |
| List() |
Retourne un tableau de chaînes nommant les fichiers et répertoires dans le répertoire indiqué par ce chemin d’accès abstrait. |
| List(IFilenameFilter) |
Retourne un tableau de chaînes nommant les fichiers et répertoires dans le répertoire indiqué par ce chemin d’accès abstrait qui satisfait le filtre spécifié. |
| ListAsync() |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. |
| ListAsync(IFilenameFilter) |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. |
| ListFiles() |
Retourne un tableau de chemins d’accès abstraits indiquant les fichiers dans le répertoire indiqué par ce chemin d’accès abstrait. |
| ListFiles(IFileFilter) |
Retourne un tableau de chemins d’accès abstraits indiquant les fichiers et les répertoires du répertoire indiqués par ce chemin d’accès abstrait qui répondent au filtre spécifié. |
| ListFiles(IFilenameFilter) |
Retourne un tableau de chemins d’accès abstraits indiquant les fichiers et les répertoires du répertoire indiqués par ce chemin d’accès abstrait qui répondent au filtre spécifié. |
| ListFilesAsync() |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. |
| ListFilesAsync(IFileFilter) |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. |
| ListFilesAsync(IFilenameFilter) |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. |
| ListRoots() |
Retourne les racines du système de fichiers. |
| ListRootsAsync() |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. |
| Mkdir() |
Crée le répertoire nommé par ce chemin d’accès abstrait. |
| Mkdirs() |
Crée le répertoire nommé par ce chemin d’accès abstrait, y compris les répertoires parents nécessaires mais inexistants. |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| RenameTo(File) |
Renomme le fichier indiqué par ce chemin d’accès abstrait. |
| SetExecutable(Boolean, Boolean) |
Définit l’autorisation d’exécution du propriétaire ou de tout le monde pour ce chemin d’accès abstrait. |
| SetExecutable(Boolean) |
Méthode pratique pour définir l’autorisation d’exécution du propriétaire pour ce chemin d’accès abstrait. |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetLastModified(Int64) |
Définit l’heure de dernière modification du fichier ou du répertoire nommé par ce chemin d’accès abstrait. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. (Hérité de JavaObject) |
| SetReadable(Boolean, Boolean) |
Définit l’autorisation de lecture du propriétaire ou de tout le monde pour ce chemin d’accès abstrait. |
| SetReadable(Boolean) |
Méthode pratique pour définir l’autorisation de lecture du propriétaire pour ce chemin d’accès abstrait. |
| SetReadOnly() |
Marque le fichier ou le répertoire nommé par ce chemin d’accès abstrait afin que seules les opérations de lecture soient autorisées. |
| SetWritable(Boolean, Boolean) |
Définit l’autorisation d’écriture du propriétaire ou de tout le monde pour ce chemin d’accès abstrait. |
| SetWritable(Boolean) |
Méthode pratique pour définir l’autorisation d’écriture du propriétaire pour ce chemin d’accès abstrait. |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToPath() |
Retourne un |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| ToURI() |
Construit un |
| ToURL() |
Obsolète.
Convertit ce chemin d’accès abstrait en |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object) |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IComparable.CompareTo(Object) |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. |
| IJavaPeerable.Disposed() |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. (Hérité de JavaObject) |
| IJavaPeerable.Finalized() |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. (Hérité de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. (Hérité de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. (Hérité de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. (Hérité de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. (Hérité de JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Représentation abstraite des noms de chemins d’accès de fichier et de répertoire. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |