ContextWrapper.GetExternalFilesDirs(String) Méthode

[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[]

Paramètres

Retours

Retourne des chemins absolus vers des répertoires spécifiques à l’application sur tous les appareils de stockage partagé/externe où l’application peut placer des fichiers persistants qu’elle possède. Ces fichiers sont internes à l’application et ne sont généralement pas visibles par l’utilisateur en tant que média. C’est comme getFilesDir() dans lequel ces fichiers seront supprimés lorsque l’application est désinstallée, mais il existe certaines différences importantes : le stockage partagé peut ne pas toujours être disponible, car le support amovible peut être éjecté par l’utilisateur. L’état du média peut être vérifié à l’aide de Environment.getExternalStorageState(File). Aucune sécurité n’est appliquée avec ces fichiers. Par exemple, toute application contenant des Manifest.permission.WRITE_EXTERNAL_STORAGE peut écrire dans ces fichiers. Si un périphérique de stockage partagé est émulé (tel que déterminé par Environment.isExternalStorageEmulated(File), son contenu est soutenu par une partition de données utilisateur privée, ce qui signifie qu’il n’existe aucun avantage à stocker des données ici au lieu des répertoires privés retournés par getFilesDir(), etc. Les appareils de stockage partagé retournés ici sont considérés comme une partie stable de l’appareil, y compris les emplacements multimédias physiques sous une couverture de protection. Les chemins retournés n’incluent pas d’appareils temporaires, tels que les lecteurs flash USB connectés aux appareils portables. Une application peut stocker des données sur l’un ou l’ensemble des appareils retournés. Par exemple, une application peut choisir de stocker des fichiers volumineux sur l’appareil avec l’espace le plus disponible, comme mesuré par statFs. Aucune autorisation supplémentaire n’est requise pour que l’application appelante lit ou écrit des fichiers sous le chemin d’accès retourné. L’accès en écriture en dehors de ces chemins d’accès sur les périphériques de stockage externes secondaires n’est pas disponible. Le chemin retourné peut changer au fil du temps si différents supports de stockage partagés sont insérés, de sorte que seuls les chemins relatifs doivent être conservés. Type de paramètres String : type de répertoire de fichiers à retourner. Peut être null pour la racine du répertoire de fichiers ou l’une des constantes suivantes pour un sous-répertoire : Environment.DIRECTORY_MUSIC , Environment.DIRECTORY_PODCASTS , Environment.DIRECTORY_RINGTONES , Environment.DIRECTORY_ALARMS , Environment.DIRECTORY_NOTIFICATIONS , Environment.DIRECTORY_PICTURES ou Environment.DIRECTORY_MOVIES . Renvoie le fichier[] les chemins absolus des répertoires spécifiques à l’application. Certains chemins d’accès individuels peuvent être null si ce stockage partagé n’est pas disponible actuellement. Le premier chemin retourné est le même que getExternalFilesDir(String).

Attributs

RegisterAttribute

Remarques

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.

Java documentation pour android.content.ContextWrapper.getExternalFilesDirs(java.lang.String).