File Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen.
[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- Vererbung
- Attribute
- Implementiert
Hinweise
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen.
Benutzeroberflächen und Betriebssysteme verwenden systemabhängige <Em-Pfadnamenzeichenfolgen></em> zum Benennen von Dateien und Verzeichnissen. Diese Klasse stellt eine abstrakte, systemunabhängige Ansicht von hierarchischen Pfadnamen dar. Ein <em>abstrakter Pfadname</em> verfügt über zwei Komponenten:
Der Vorname in einem abstrakten Pfadname kann ein Verzeichnisname sein, oder bei Microsoft Windows UNC-Pfadnamen ein Hostname. Jeder nachfolgende Name in einem abstrakten Pfadnamen bezeichnet ein Verzeichnis; Der Nachname kann entweder ein Verzeichnis oder eine Datei kennzeichnen. Der <abstrakte Pfadname "em>empty</em> " weist kein Präfix und eine leere Namenssequenz auf.
Die Konvertierung einer Pfadnamenzeichenfolge in oder aus einem abstrakten Pfadnamen ist systemabhängig. Wenn ein abstrakter Pfadname in eine Pfadnamezeichenfolge konvertiert wird, wird jeder Name von der nächsten durch eine einzelne Kopie des Standardtrennzeichens<>/<em> getrennt. Das Standardmäßige Namenstrennzeichen wird durch die Systemeigenschaft file.separatordefiniert und in den öffentlichen statischen Feldern {@link #separator} und {@link #separatorChar} dieser Klasse zur Verfügung gestellt. Wenn eine Pfadnamezeichenfolge in einen abstrakten Pfadnamen konvertiert wird, können die darin enthaltenen Namen durch das Standardmäßige Namenstrennzeichen oder durch ein anderes Vom zugrunde liegenden System unterstütztes Namenstrennzeichen getrennt werden.
Ein Pfadname, ob abstrakt oder in Zeichenfolgenform, kann entweder <"absolut></em>" oder <"em>relative</em>" sein. Ein absoluter Pfadname ist abgeschlossen, da keine anderen Informationen erforderlich sind, um die Datei zu finden, die sie angibt. Ein relativer Pfadname muss im Gegensatz dazu in Bezug auf Informationen aus einem anderen Pfadnamen interpretiert werden. Standardmäßig lösen die Klassen im java.io Paket immer relative Pfadnamen für das aktuelle Benutzerverzeichnis auf. Dieses Verzeichnis wird von der Systemeigenschaft user.dirbenannt und ist in der Regel das Verzeichnis, in dem der Java virtuellen Computer aufgerufen wurde.
Das <übergeordnete> Em-Element<> eines abstrakten Pfadnamens kann durch Aufrufen der #getParent Methode dieser Klasse abgerufen werden und besteht aus dem Präfix des Pfadnamens und jedem Namen in der Namenssequenz des Pfadnamens mit Ausnahme der letzten. Der absolute Pfadname jedes Verzeichnisses ist ein Vorgänger eines Objekts File mit einem absoluten abstrakten Pfadnamen, der mit dem absoluten Pfadnamen des Verzeichnisses beginnt. Das verzeichnis, das durch den abstrakten Pfadnamen "/usr" gekennzeichnet ist, ist beispielsweise ein Vorgänger des Verzeichnisses, das durch den Pfadnamen "/usr/local/bin"gekennzeichnet ist.
Das Präfixkonzept wird verwendet, um Stammverzeichnisse auf UNIX-Plattformen und Laufwerksbezeichner, Stammverzeichnisse und UNC-Pfadnamen auf Microsoft Windows Plattformen wie folgt zu verarbeiten:
<Ul>
<li> Für UNIX-Plattformen ist das Präfix eines absoluten Pfadnamens immer "/". Relative Pfadnamen haben kein Präfix. Der abstrakte Pfadname, der das Stammverzeichnis angibt, weist das Präfix "/" und eine leere Namenssequenz auf.
<li> Für Microsoft Windows-Plattformen besteht das Präfix eines Pfadnamens, der einen Laufwerksbezeichner enthält, aus dem Laufwerkbuchstaben gefolgt von ":" und möglicherweise gefolgt, "\\" wenn der Pfadname absolut ist. Das Präfix eines UNC-Pfadnamens lautet "\\\\"; der Hostname und der Freigabename sind die ersten beiden Namen in der Namenssequenz. Ein relativer Pfadname, der kein Laufwerk angibt, weist kein Präfix auf.
</ul>
Instanzen dieser Klasse können ein tatsächliches Dateisystemobjekt, z. B. eine Datei oder ein Verzeichnis, kennzeichnen oder nicht. Wenn es ein solches Objekt angibt, befindet sich das Objekt in einer Partition. Eine Partition ist ein betriebssystemspezifischer Teil des Speichers für ein Dateisystem. Ein einzelnes Speichergerät (z. B. ein physisches Laufwerk, Flashspeicher, CD-ROM) kann mehrere Partitionen enthalten. Wenn vorhanden, befindet sich das Objekt auf der Partition "partName">, die von einem Vorgänger der absoluten Form dieses Pfadnamens benannt wurde.
Ein Dateisystem kann Einschränkungen für bestimmte Vorgänge für das tatsächliche Dateisystemobjekt implementieren, z. B. Lesen, Schreiben und Ausführen. Diese Einschränkungen werden gemeinsam als Zugriffsberechtigungen bezeichnet. Das Dateisystem verfügt möglicherweise über mehrere Zugriffsberechtigungen für ein einzelnes Objekt. Beispielsweise kann ein Satz auf den Besitzer des Objekts angewendet werden, und ein anderer kann für alle anderen Benutzer gelten. Die Zugriffsberechtigungen für ein Objekt können dazu führen, dass einige Methoden in dieser Klasse fehlschlagen.
Instanzen der File Klasse sind unveränderlich, d. h., sobald sie erstellt wurden, ändert sich der abstrakte Pfadname, der durch ein File Objekt dargestellt wird, nie mehr.
<h3>Interoperabilität mit java.nio.file Paket</h3>
Das <Paket c> java.nio.file</c> definiert Schnittstellen und Klassen für den Java virtuellen Computer für den Zugriff auf Dateien, Dateiattribute und Dateisysteme. Diese API kann verwendet werden, um viele der Einschränkungen der java.io.File Klasse zu überwinden. Die #toPath toPath Methode kann verwendet werden, um einen Path abzurufen, der den abstrakten Pfad verwendet, der durch ein File Objekt dargestellt wird, um eine Datei zu suchen. Die resultierende Path Kann mit der java.nio.file.Files Klasse verwendet werden, um effizienteren und umfangreicheren Zugriff auf zusätzliche Dateivorgänge, Dateiattribute und E/A-Ausnahmen zu ermöglichen, um Fehler zu diagnostizieren, wenn ein Vorgang für eine Datei fehlschlägt.
Unter Android-Zeichenfolgen werden beim Senden von Dateinamen an das Betriebssystem in UTF-8-Bytesequenzen konvertiert, und bytesequenzen, die vom Betriebssystem (aus den verschiedenen list Methoden) zurückgegeben werden, werden durch Decodieren als UTF-8-Bytesequenzen in Zeichenfolgen konvertiert.
In JDK1.0 hinzugefügt.
Java Dokumentation für java.io.File.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Konstruktoren
| Name | Beschreibung |
|---|---|
| File(File, String) |
Erstellt eine neue |
| File(IntPtr, JniHandleOwnership) |
Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen. |
| File(String, String) |
Erstellt eine neue |
| File(String) |
Erstellt eine neue |
| File(URI) |
Erstellt eine neue |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AbsoluteFile |
Gibt die absolute Form dieses abstrakten Pfadnamens zurück. |
| AbsolutePath |
Gibt den absoluten Pfad dieser Datei zurück. |
| CanonicalFile |
Gibt die kanonische Form dieses abstrakten Pfadnamens zurück. |
| CanonicalPath |
Gibt die kanonische Pfadnamezeichenfolge dieses abstrakten Pfadnamens zurück. |
| Class |
Gibt die Laufzeitklasse dieses Werts |
| FreeSpace |
Gibt die Anzahl nicht zugewiesener Bytes in der Partition zurück, die durch diesen abstrakten Pfadnamen benannt ist. |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| IsAbsolute |
Testet, ob dieser abstrakte Pfadname absolut ist. |
| IsDirectory |
Überprüft, ob die datei, die durch diesen abstrakten Pfadnamen gekennzeichnet ist, ein Verzeichnis ist. |
| IsFile |
Überprüft, ob die durch diesen abstrakten Pfadnamen angegebene Datei eine normale Datei ist. |
| IsHidden |
Testet, ob die von diesem abstrakten Pfadname benannte Datei eine ausgeblendete Datei ist. |
| JniIdentityHashCode |
Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object) |
| JniManagedPeerState |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. (Geerbt von JavaObject) |
| JniPeerMembers |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. |
| Name |
Gibt den Namen der Datei oder des Verzeichnisses zurück, die durch diesen abstrakten Pfadnamen gekennzeichnet ist. |
| Parent |
Gibt die Pfadnamezeichenfolge des übergeordneten Pfadnamens dieses abstrakten Pfadnamens zurück, oder |
| ParentFile |
Gibt den abstrakten Pfadnamen des übergeordneten Pfadnamens dieses abstrakten Pfads zurück, oder |
| Path |
Konvertiert diesen abstrakten Pfadnamen in eine Pfadnamezeichenfolge. |
| PathSeparator |
Das systemabhängige Pfadtrennzeichen, dargestellt als Zeichenfolge zur Vereinfachung. |
| PathSeparatorChar |
Das systemabhängige Pfadtrennzeichen. |
| PeerReference |
Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object) |
| Separator |
Das systemabhängige Standardnamentrennzeichen, dargestellt als Zeichenfolge zur Vereinfachung. |
| SeparatorChar |
Das systemabhängige Standardnamentrennzeichen. |
| ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
| ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
| TotalSpace |
Gibt die Größe der Partition zurück, die von diesem abstrakten Pfadnamen benannt wird. |
| UsableSpace |
Gibt die Anzahl der Bytes zurück, die für diesen virtuellen Computer auf der Partition verfügbar sind, die durch diesen abstrakten Pfadnamen benannt ist. |
Methoden
| Name | Beschreibung |
|---|---|
| CanExecute() |
Testet, ob die Anwendung die Datei ausführen kann, die durch diesen abstrakten Pfadnamen gekennzeichnet ist. |
| CanRead() |
Testet, ob die Anwendung die Datei lesen kann, die durch diesen abstrakten Pfadnamen gekennzeichnet ist. |
| CanWrite() |
Überprüft, ob die Anwendung die Datei ändern kann, die durch diesen abstrakten Pfadnamen gekennzeichnet ist. |
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
| CompareTo(File) |
Vergleicht zwei abstrakte Pfadnamen lexikalisch. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. (Geerbt von JavaObject) |
| CreateNewFile() |
Atomically creates a new, empty file named by this abstract pathname if and only if a file with this name does not exist. |
| CreateTempFile(String, String, File) |
Erstellt eine neue leere Datei im angegebenen Verzeichnis, wobei die angegebenen Präfix- und Suffixzeichenfolgen verwendet werden, um ihren Namen zu generieren. |
| CreateTempFile(String, String) |
Erstellt eine leere Datei im Standardverzeichnis für temporäre Dateien, wobei das angegebene Präfix und Suffix verwendet werden, um den Namen zu generieren. |
| Delete() |
Löscht die Datei oder das Verzeichnis, die durch diesen abstrakten Pfadnamen gekennzeichnet ist. |
| DeleteOnExit() |
Fordert an, dass die datei oder das Verzeichnis, die durch diesen abstrakten Pfadnamen gekennzeichnet ist, gelöscht werden, wenn der virtuelle Computer beendet wird. |
| Dispose() |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| Dispose(Boolean) |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| DisposeUnlessReferenced() |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. (Geerbt von JavaObject) |
| Equals(Object) |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. (Geerbt von JavaObject) |
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| Exists() |
Testet, ob die Datei oder das Verzeichnis, die durch diesen abstrakten Pfadnamen gekennzeichnet ist, vorhanden ist. |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| LastModified() |
Gibt die Uhrzeit zurück, zu der die Datei, die von diesem abstrakten Pfadnamen angegeben wurde, zuletzt geändert wurde. |
| Length() |
Gibt die Länge der Datei zurück, die durch diesen abstrakten Pfadnamen gekennzeichnet ist. |
| List() |
Gibt ein Array von Zeichenfolgen zurück, die die Dateien und Verzeichnisse im Verzeichnis benennen, das durch diesen abstrakten Pfadnamen gekennzeichnet ist. |
| List(IFilenameFilter) |
Gibt ein Array von Zeichenfolgen zurück, die die Dateien und Verzeichnisse im Verzeichnis benennen, die durch diesen abstrakten Pfadnamen gekennzeichnet sind, der den angegebenen Filter erfüllt. |
| ListAsync() |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. |
| ListAsync(IFilenameFilter) |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. |
| ListFiles() |
Gibt ein Array abstrakter Pfadnamen zurück, das die Dateien im Verzeichnis angibt, die durch diesen abstrakten Pfadnamen gekennzeichnet sind. |
| ListFiles(IFileFilter) |
Gibt ein Array abstrakter Pfadnamen zurück, das die Dateien und Verzeichnisse im Verzeichnis angibt, das durch diesen abstrakten Pfadnamen gekennzeichnet ist, der den angegebenen Filter erfüllt. |
| ListFiles(IFilenameFilter) |
Gibt ein Array abstrakter Pfadnamen zurück, das die Dateien und Verzeichnisse im Verzeichnis angibt, das durch diesen abstrakten Pfadnamen gekennzeichnet ist, der den angegebenen Filter erfüllt. |
| ListFilesAsync() |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. |
| ListFilesAsync(IFileFilter) |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. |
| ListFilesAsync(IFilenameFilter) |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. |
| ListRoots() |
Gibt die Dateisystemwurzeln zurück. |
| ListRootsAsync() |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. |
| Mkdir() |
Erstellt das Verzeichnis, das mit diesem abstrakten Pfadnamen benannt wird. |
| Mkdirs() |
Erstellt das verzeichnis, das durch diesen abstrakten Pfadnamen benannt wird, einschließlich aller erforderlichen, aber nicht vorhandenen übergeordneten Verzeichnisse. |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| RenameTo(File) |
Benennt die Datei um, die durch diesen abstrakten Pfadnamen gekennzeichnet ist. |
| SetExecutable(Boolean, Boolean) |
Legt die Berechtigung "Besitzer" oder "Jeder" für diesen abstrakten Pfadnamen fest. |
| SetExecutable(Boolean) |
Eine Komfortmethode zum Festlegen der Ausführungsberechtigung des Besitzers für diesen abstrakten Pfadnamen. |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| SetLastModified(Int64) |
Legt die Uhrzeit der letzten Änderung der Datei oder des Verzeichnisses fest, die durch diesen abstrakten Pfadnamen benannt ist. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. (Geerbt von JavaObject) |
| SetReadable(Boolean, Boolean) |
Legt die Leseberechtigung des Besitzers oder aller Benutzer für diesen abstrakten Pfadnamen fest. |
| SetReadable(Boolean) |
Eine Komfortmethode zum Festlegen der Leseberechtigung des Besitzers für diesen abstrakten Pfadnamen. |
| SetReadOnly() |
Markiert die Datei oder das Verzeichnis, die durch diesen abstrakten Pfadnamen benannt ist, sodass nur Lesevorgänge zulässig sind. |
| SetWritable(Boolean, Boolean) |
Legt die Schreibberechtigung des Besitzers oder aller Benutzer für diesen abstrakten Pfadnamen fest. |
| SetWritable(Boolean) |
Eine Komfortmethode zum Festlegen der Schreibberechtigung des Besitzers für diesen abstrakten Pfadnamen. |
| ToArray<T>() |
Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object) |
| ToPath() |
Gibt ein |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| ToURI() |
Erstellt einen |
| ToURL() |
Veraltet.
Konvertiert diesen abstrakten Pfadnamen in eine |
| UnregisterFromRuntime() |
Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object) |
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IComparable.CompareTo(Object) |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. |
| IJavaPeerable.Disposed() |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. (Geerbt von JavaObject) |
| IJavaPeerable.Finalized() |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. (Geerbt von JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. (Geerbt von JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. (Geerbt von JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. (Geerbt von JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. (Geerbt von JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
Eine abstrakte Darstellung von Datei- und Verzeichnispfadnamen. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |