ContextWrapper.GetExternalFilesDirs(String) Methode

[Android.Runtime.Register("getExternalFilesDirs", "(Ljava/lang/String;)[Ljava/io/File;", "GetGetExternalFilesDirs_Ljava_lang_String_Handler")]
public override Java.IO.File[]? GetExternalFilesDirs(string? type);

[<Android.Runtime.Register("getExternalFilesDirs", "(Ljava/lang/String;)[Ljava/io/File;", "GetGetExternalFilesDirs_Ljava_lang_String_Handler")>]
override this.GetExternalFilesDirs : string -> Java.IO.File[]

Parameter

Gibt zurück

Gibt absolute Pfade zu anwendungsspezifischen Verzeichnissen auf allen freigegebenen/externen Speichergeräten zurück, auf denen die Anwendung dauerhafte Dateien speichern kann, die sie besitzen. Diese Dateien sind intern für die Anwendung und in der Regel nicht für den Benutzer als Medien sichtbar. Dies ist wie "getFilesDir()", da diese Dateien gelöscht werden, wenn die Anwendung deinstalliert wird. Es gibt jedoch einige wichtige Unterschiede: Der freigegebene Speicher ist möglicherweise nicht immer verfügbar, da Wechselmedien vom Benutzer ausgeworfen werden können. Der Medienstatus kann mithilfe von Environment.getExternalStorageState(File) überprüft werden. Mit diesen Dateien wird keine Sicherheit erzwungen. Beispielsweise kann jede Anwendung, die Manifest.permission.WRITE_EXTERNAL_STORAGE enthält, in diese Dateien schreiben. Wenn ein freigegebenes Speichergerät emuliert wird (wie durch Environment.isExternalStorageEmulated(File) bestimmt), werden seine Inhalte von einer privaten Benutzerdatenpartition gesichert, was bedeutet, dass es wenig Vorteile zum Speichern von Daten hier anstelle der privaten Verzeichnisse gibt, die von getFilesDir() zurückgegeben werden usw. Freigegebene Speichergeräte, die hier zurückgegeben werden, gelten als stabiler Teil des Geräts, einschließlich physischer Medienplätze unter einer Schutzabdeckung. Die zurückgegebenen Pfade enthalten keine vorübergehenden Geräte, z. B. USB-Speichersticks, die mit Handheld-Geräten verbunden sind. Eine Anwendung kann Daten auf einem oder allen zurückgegebenen Geräten speichern. Eine App kann z. B. große Dateien auf dem Gerät mit dem am häufigsten verfügbaren Speicherplatz speichern, wie durch StatFs gemessen. Für die aufrufende App sind keine zusätzlichen Berechtigungen erforderlich, um Dateien unter dem zurückgegebenen Pfad zu lesen oder zu schreiben. Schreibzugriff außerhalb dieser Pfade auf sekundären externen Speichergeräten ist nicht verfügbar. Der zurückgegebene Pfad kann sich im Laufe der Zeit ändern, wenn verschiedene freigegebene Speichermedien eingefügt werden, sodass nur relative Pfade beibehalten werden sollten. Parametertyp String : Der Typ des zurückzugebenden Dateiverzeichnisses. Kann null für das Stammverzeichnis der Dateien oder eine der folgenden Konstanten für ein Unterverzeichnis sein: Environment.DIRECTORY_MUSIC , Environment.DIRECTORY_PODCASTS , Environment.DIRECTORY_RINGTONES , Environment.DIRECTORY_ALARMS , Environment.DIRECTORY_NOTIFICATIONS , Environment.DIRECTORY_PICTURES oder Environment.DIRECTORY_MOVIES . Gibt File[] die absoluten Pfade zu anwendungsspezifischen Verzeichnissen zurück. Einige einzelne Pfade sind möglicherweise NULL, wenn dieser freigegebene Speicher derzeit nicht verfügbar ist. Der erste zurückgegebene Pfad ist identisch mit getExternalFilesDir(String) .

Attribute

RegisterAttribute

Hinweise

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.

Java Dokumentation für android.content.ContextWrapper.getExternalFilesDirs(java.lang.String).