File Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresentazione astratta dei nomi di percorso di file e directory.
[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- Ereditarietà
- Attributi
- Implementazioni
Commenti
Rappresentazione astratta dei nomi di percorso di file e directory.
Le interfacce utente e i sistemi operativi usano stringhe< pathname dipendenti dal ><sistema/em> per denominare file e directory. Questa classe presenta una visualizzazione astratta indipendente dal sistema dei nomi di percorso gerarchici. Un <em>abstract pathname</em> ha due componenti:
Il nome in un percorso astratto può essere un nome di directory o, nel caso di Microsoft Windows nomi di percorso UNC, un nome host. Ogni nome successivo in un percorso astratto denota una directory; il cognome può indicare una directory o un file. Il <percorso astratto em empty>/em<> non ha prefisso e una sequenza di nomi vuota.
La conversione di una stringa pathname in o da un pathname astratto è intrinsecamente dipendente dal sistema. Quando un pathname astratto viene convertito in una stringa pathname, ogni nome viene separato dal successivo da una singola copia del carattere< separatore em>predefinito</em>. Il carattere separatore dei nomi predefinito è definito dalla proprietà file.separatordi sistema e viene reso disponibile nei campi {@link #separator} statici pubblici e {@link #separatorChar} di questa classe. Quando una stringa pathname viene convertita in un percorso astratto, i nomi all'interno di esso possono essere separati dal carattere separatore del nome predefinito o da qualsiasi altro carattere separatore nome supportato dal sistema sottostante.
Un pathname, astratto o in formato stringa, può essere em absolute/em< o >em<relative>/em<.><> Un percorso assoluto è completo in quanto non sono necessarie altre informazioni per individuare il file indicato. Un pathname relativo, al contrario, deve essere interpretato in termini di informazioni ricavate da un altro nome di percorso. Per impostazione predefinita, le classi nel java.io pacchetto risolvono sempre i pathname relativi nella directory utente corrente. Questa directory è denominata dalla proprietà user.dirdi sistema ed è in genere la directory in cui è stata richiamata la macchina virtuale Java.
L'em <parent/em>< di un pathname astratto può essere ottenuto richiamando il > metodo di questa classe ed è costituito dal prefisso del nome del percorso e da ogni nome nella sequenza del nome del percorso, ad eccezione dell'ultimo#getParent. Il percorso assoluto di ogni directory è un predecessore di qualsiasi File oggetto con un percorso astratto assoluto che inizia con il percorso assoluto della directory. Ad esempio, la directory indicata dal nome percorso "/usr" astratto è un predecessore della directory indicata dal nome percorso "/usr/local/bin".
Il concetto di prefisso viene usato per gestire le directory radice nelle piattaforme UNIX e gli identificatori di unità, le directory radice e i nomi di percorso UNC nelle piattaforme Microsoft Windows, come indicato di seguito:
<ul>
<li> Per le piattaforme UNIX, il prefisso di un percorso assoluto è sempre "/". I pathname relativi non hanno prefisso. Il nome percorso astratto che indica la directory radice ha il prefisso "/" e una sequenza di nomi vuota.
<li> Per Microsoft Windows piattaforme, il prefisso di un pathname che contiene un identificatore di unità è costituito dalla lettera di unità seguita da ":" ed eventualmente seguita da "\\" se il nome percorso è assoluto. Il prefisso di un nome percorso UNC è "\\\\". Il nome host e il nome della condivisione sono i primi due nomi nella sequenza di nomi. Un percorso relativo che non specifica un'unità non ha prefisso.
</ul>
Le istanze di questa classe possono indicare o meno un oggetto file system effettivo, ad esempio un file o una directory. Se indica tale oggetto, tale oggetto risiede in una partizione. Una partizione è una parte specifica del sistema operativo di archiviazione per un file system. Un singolo dispositivo di archiviazione (ad esempio, un'unità disco fisico, memoria flash, CD-ROM) può contenere più partizioni. L'oggetto, se presente, risiederà nella partizione "partName"> denominata da un predecessore della forma assoluta di questo pathname.
Un file system può implementare restrizioni per determinate operazioni sull'oggetto file system effettivo, ad esempio lettura, scrittura ed esecuzione. Queste restrizioni sono note collettivamente come autorizzazioni di accesso. Il file system può avere più set di autorizzazioni di accesso per un singolo oggetto. Ad esempio, un set può essere applicato al proprietario dell'oggetto e un altro può essere applicato a tutti gli altri utenti. Le autorizzazioni di accesso per un oggetto possono causare l'esito negativo di alcuni metodi in questa classe.
Le istanze della File classe non sono modificabili, ovvero dopo la creazione, il percorso astratto rappresentato da un File oggetto non cambierà mai.
<Interoperabilità h3>con java.nio.file package</h3>
Il <pacchetto c> java.nio.file</c> definisce interfacce e classi per la macchina virtuale Java per accedere a file, attributi di file e file system. Questa API può essere usata per superare molte delle limitazioni della java.io.File classe . Il #toPath toPath metodo può essere utilizzato per ottenere un Path oggetto che utilizza il percorso astratto rappresentato da un File oggetto per individuare un file. L'oggetto risultante Path può essere usato con la java.nio.file.Files classe per fornire un accesso più efficiente e completo a operazioni aggiuntive sui file, attributi di file ed eccezioni di I/O per diagnosticare gli errori in caso di errore di un'operazione in un file.
Nelle stringhe Android vengono convertite in sequenze di byte UTF-8 quando si inviano nomi file al sistema operativo e le sequenze di byte restituite dal sistema operativo (dai vari list metodi) vengono convertite in stringhe decodificandole come sequenze di byte UTF-8.
Aggiunta in JDK1.0.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.
Costruttori
| Nome | Descrizione |
|---|---|
| File(File, String) |
Crea una nuova |
| File(IntPtr, JniHandleOwnership) |
Costruttore usato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime. |
| File(String, String) |
Crea una nuova |
| File(String) |
Crea una nuova |
| File(URI) |
Crea una nuova |
Proprietà
| Nome | Descrizione |
|---|---|
| AbsoluteFile |
Restituisce la forma assoluta di questo percorso astratto. |
| AbsolutePath |
Restituisce il percorso assoluto del file. |
| CanonicalFile |
Restituisce la forma canonica di questo percorso astratto. |
| CanonicalPath |
Restituisce la stringa pathname canonica di questo percorso astratto. |
| Class |
Restituisce la classe di runtime di questo |
| FreeSpace |
Restituisce il numero di byte non allocati nella partizione denominata da questo nome di percorso astratto. |
| Handle |
Handle per l'istanza di Android sottostante. (Ereditato da Object) |
| IsAbsolute |
Verifica se questo percorso astratto è assoluto. |
| IsDirectory |
Verifica se il file indicato da questo percorso astratto è una directory. |
| IsFile |
Verifica se il file indicato da questo percorso astratto è un file normale. |
| IsHidden |
Verifica se il file denominato da questo percorso astratto è un file nascosto. |
| JniIdentityHashCode |
Ottiene il codice hash di identità assegnato a questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| JniManagedPeerState |
Rappresentazione astratta dei nomi di percorso di file e directory. (Ereditato da JavaObject) |
| JniPeerMembers |
Rappresentazione astratta dei nomi di percorso di file e directory. |
| Name |
Restituisce il nome del file o della directory indicato da questo percorso astratto. |
| Parent |
Restituisce la stringa pathname dell'elemento padre del percorso astratto oppure |
| ParentFile |
Restituisce il percorso astratto dell'elemento padre del nome percorso astratto oppure |
| Path |
Converte questo percorso astratto in una stringa pathname. |
| PathSeparator |
Carattere separatore di percorso dipendente dal sistema, rappresentato come stringa per praticità. |
| PathSeparatorChar |
Carattere separatore di percorso dipendente dal sistema. |
| PeerReference |
Ottiene il riferimento all'oggetto JNI per questo peer Java. (Ereditato da Object) |
| Separator |
Carattere separatore del nome predefinito dipendente dal sistema, rappresentato come stringa per praticità. |
| SeparatorChar |
Carattere separatore del nome predefinito dipendente dal sistema. |
| ThresholdClass |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
| ThresholdType |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
| TotalSpace |
Restituisce le dimensioni della partizione denominata da questo percorso astratto. |
| UsableSpace |
Restituisce il numero di byte disponibili per questa macchina virtuale nella partizione denominata da questo percorso astratto. |
Metodi
| Nome | Descrizione |
|---|---|
| CanExecute() |
Verifica se l'applicazione può eseguire il file indicato da questo percorso astratto. |
| CanRead() |
Verifica se l'applicazione può leggere il file indicato da questo percorso astratto. |
| CanWrite() |
Verifica se l'applicazione può modificare il file indicato da questo percorso astratto. |
| Clone() |
Crea e restituisce una copia di questo oggetto. (Ereditato da Object) |
| CompareTo(File) |
Confronta due pathname astratti in modo lessicografico. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Rappresentazione astratta dei nomi di percorso di file e directory. (Ereditato da JavaObject) |
| CreateNewFile() |
Crea in modo atomico un nuovo file vuoto denominato da questo percorso astratto se e solo se un file con questo nome non esiste ancora. |
| CreateTempFile(String, String, File) |
Crea un nuovo file vuoto nella directory specificata, usando il prefisso e le stringhe di suffisso specificati per generarne il nome. |
| CreateTempFile(String, String) |
Crea un file vuoto nella directory predefinita del file temporaneo, usando il prefisso e il suffisso specificati per generarne il nome. |
| Delete() |
Elimina il file o la directory indicata da questo percorso astratto. |
| DeleteOnExit() |
Richiede l'eliminazione del file o della directory da questo percorso astratto quando la macchina virtuale termina. |
| Dispose() |
Rilascia le risorse contenute in questo peer Java. (Ereditato da Object) |
| Dispose(Boolean) |
Rilascia le risorse contenute in questo peer Java. (Ereditato da Object) |
| DisposeUnlessReferenced() |
Rappresentazione astratta dei nomi di percorso di file e directory. (Ereditato da JavaObject) |
| Equals(Object) |
Rappresentazione astratta dei nomi di percorso di file e directory. (Ereditato da JavaObject) |
| Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
| Exists() |
Verifica se il file o la directory indicato da questo percorso astratto esiste. |
| GetHashCode() |
Restituisce un valore di codice hash per l'oggetto . (Ereditato da Object) |
| JavaFinalize() |
Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object) |
| LastModified() |
Restituisce l'ora dell'ultima modifica apportata al file indicato da questo percorso astratto. |
| Length() |
Restituisce la lunghezza del file indicato da questo percorso astratto. |
| List() |
Restituisce una matrice di stringhe che denominano i file e le directory nella directory indicata da questo percorso astratto. |
| List(IFilenameFilter) |
Restituisce una matrice di stringhe che denominano i file e le directory nella directory indicata da questo percorso astratto che soddisfa il filtro specificato. |
| ListAsync() |
Rappresentazione astratta dei nomi di percorso di file e directory. |
| ListAsync(IFilenameFilter) |
Rappresentazione astratta dei nomi di percorso di file e directory. |
| ListFiles() |
Restituisce una matrice di nomi di percorso astratti che denota i file nella directory indicata da questo percorso astratto. |
| ListFiles(IFileFilter) |
Restituisce una matrice di nomi di percorso astratti che denominano i file e le directory nella directory indicati da questo percorso astratto che soddisfano il filtro specificato. |
| ListFiles(IFilenameFilter) |
Restituisce una matrice di nomi di percorso astratti che denominano i file e le directory nella directory indicati da questo percorso astratto che soddisfano il filtro specificato. |
| ListFilesAsync() |
Rappresentazione astratta dei nomi di percorso di file e directory. |
| ListFilesAsync(IFileFilter) |
Rappresentazione astratta dei nomi di percorso di file e directory. |
| ListFilesAsync(IFilenameFilter) |
Rappresentazione astratta dei nomi di percorso di file e directory. |
| ListRoots() |
Restituisce le radici del file system. |
| ListRootsAsync() |
Rappresentazione astratta dei nomi di percorso di file e directory. |
| Mkdir() |
Crea la directory denominata da questo percorso astratto. |
| Mkdirs() |
Crea la directory denominata da questo percorso astratto, incluse le directory padre necessarie ma inesistente. |
| Notify() |
Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
| NotifyAll() |
Riattiva tutti i thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
| RenameTo(File) |
Rinomina il file indicato da questo percorso astratto. |
| SetExecutable(Boolean, Boolean) |
Imposta l'autorizzazione di esecuzione del proprietario o di tutti per questo percorso astratto. |
| SetExecutable(Boolean) |
Metodo pratico per impostare l'autorizzazione di esecuzione del proprietario per questo percorso astratto. |
| SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
| SetLastModified(Int64) |
Imposta l'ora dell'ultima modifica del file o della directory denominata da questo percorso astratto. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Rappresentazione astratta dei nomi di percorso di file e directory. (Ereditato da JavaObject) |
| SetReadable(Boolean, Boolean) |
Imposta l'autorizzazione di lettura del proprietario o di tutti per questo percorso astratto. |
| SetReadable(Boolean) |
Metodo pratico per impostare l'autorizzazione di lettura del proprietario per questo percorso astratto. |
| SetReadOnly() |
Contrassegna il file o la directory denominata da questo percorso astratto in modo che siano consentite solo le operazioni di lettura. |
| SetWritable(Boolean, Boolean) |
Imposta l'autorizzazione di scrittura del proprietario o di tutti per questo percorso astratto. |
| SetWritable(Boolean) |
Metodo pratico per impostare l'autorizzazione di scrittura del proprietario per questo percorso astratto. |
| ToArray<T>() |
Crea una matrice gestita da questo wrapper di matrice Java. (Ereditato da Object) |
| ToPath() |
Restituisce un |
| ToString() |
Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object) |
| ToURI() |
Costruisce un |
| ToURL() |
Obsoleti.
Converte questo percorso astratto in un |
| UnregisterFromRuntime() |
Annulla la registrazione di questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| Wait() |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object) |
| Wait(Int64, Int32) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
| Wait(Int64) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IComparable.CompareTo(Object) |
Rappresentazione astratta dei nomi di percorso di file e directory. |
| IJavaPeerable.Disposed() |
Rappresentazione astratta dei nomi di percorso di file e directory. (Ereditato da JavaObject) |
| IJavaPeerable.Finalized() |
Rappresentazione astratta dei nomi di percorso di file e directory. (Ereditato da JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Rappresentazione astratta dei nomi di percorso di file e directory. (Ereditato da JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Rappresentazione astratta dei nomi di percorso di file e directory. (Ereditato da JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Rappresentazione astratta dei nomi di percorso di file e directory. (Ereditato da JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Rappresentazione astratta dei nomi di percorso di file e directory. (Ereditato da JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Rappresentazione astratta dei nomi di percorso di file e directory. |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ottiene il nome JNI del tipo dell'istanza |
| JavaAs<TResult>(IJavaPeerable) |
Provare a digitare |
| JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo di tipo controllato dal runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Rappresentazione astratta dei nomi di percorso di file e directory. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Provare a digitare |