Context.GetExternalFilesDir(String) Methode

Definition

Namespace:: Android.Content

Assembly:: Mono.Android.dll

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.

Gibt den absoluten Pfad zum Verzeichnis auf dem primären freigegebenen/externen Speichergerät zurück, auf dem die Anwendung dauerhafte Dateien ablegen kann, die sie besitzen.

[Android.Runtime.Register("getExternalFilesDir", "(Ljava/lang/String;)Ljava/io/File;", "GetGetExternalFilesDir_Ljava_lang_String_Handler")]
public abstract Java.IO.File? GetExternalFilesDir(string? type);

[<Android.Runtime.Register("getExternalFilesDir", "(Ljava/lang/String;)Ljava/io/File;", "GetGetExternalFilesDir_Ljava_lang_String_Handler")>]
abstract member GetExternalFilesDir : string -> Java.IO.File

Parameter

type: String

Der Dateityp, der zurückgegeben werden soll. Kann für das Stammverzeichnis der Dateien oder eine der folgenden Konstanten für ein Unterverzeichnis verwendet werdennull: android.os.Environment#DIRECTORY_MUSIC, , android.os.Environment#DIRECTORY_PODCASTSandroid.os.Environment#DIRECTORY_RINGTONES, android.os.Environment#DIRECTORY_ALARMS, android.os.Environment#DIRECTORY_NOTIFICATIONS, android.os.Environment#DIRECTORY_PICTURESoder android.os.Environment#DIRECTORY_MOVIES.

Gibt zurück

File

der absolute Pfad zum anwendungsspezifischen Verzeichnis. Kann zurückgegeben werden null , wenn der freigegebene Speicher zurzeit nicht verfügbar ist.

Attribute: RegisterAttribute

Hinweise

Gibt den absoluten Pfad zum Verzeichnis auf dem primären freigegebenen/externen Speichergerät zurück, auf dem die Anwendung dauerhafte Dateien ablegen kann, die sie besitzen. Diese Dateien sind intern für die Anwendungen und in der Regel nicht für den Benutzer als Medien sichtbar.

Dies ist so #getFilesDir() , als diese Dateien gelöscht werden, wenn die Anwendung deinstalliert wird, es gibt jedoch einige wichtige Unterschiede: <ul><li>Shared Storage ist möglicherweise nicht immer verfügbar, da Wechselmedien vom Benutzer ausgeworfen werden können. Der Medienzustand kann mithilfe von Environment#getExternalStorageState(File) <li>Es gibt keine Sicherheit, die mit diesen Dateien erzwungen wird. Beispielsweise kann jede Anwendungshaltung android.Manifest.permission#WRITE_EXTERNAL_STORAGE in diese Dateien schreiben. </ul>

Wenn ein freigegebenes Speichergerät emuliert wird (wie bestimmt Environment#isExternalStorageEmulated(File)), werden seine Inhalte von einer privaten Benutzerdatenpartition gesichert, was bedeutet, dass es wenig Vorteile beim Speichern von Daten hier anstelle der privaten Verzeichnisse gibt, die von #getFilesDir(), usw. zurückgegeben werden.

android.os.Build.VERSION_CODES#KITKATAb , sind keine Berechtigungen erforderlich, um den zurückgegebenen Pfad zu lesen oder in den zurückgegebenen Pfad zu schreiben. Sie ist immer für die aufrufende App zugänglich. Dies gilt nur für Pfade, die für den Paketnamen der aufrufenden Anwendung generiert werden. Um auf Pfade zuzugreifen, die zu anderen Paketen gehören und android.Manifest.permission#WRITE_EXTERNAL_STORAGE /oder android.Manifest.permission#READ_EXTERNAL_STORAGE erforderlich sind.

Auf Geräten mit mehreren Benutzern (wie beschrieben UserManager) verfügt jeder Benutzer über einen eigenen isolierten freigegebenen Speicher. Anwendungen haben nur Zugriff auf den freigegebenen Speicher für den Benutzer, auf den er ausgeführt wird.

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.

Nachfolgend finden Sie ein Beispiel für typischen Code zum Bearbeiten einer Datei im freigegebenen Speicher einer Anwendung:

{

Java Dokumentation für android.content.Context.getExternalFilesDir(java.lang.String).

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.

Gilt für: