Context.GetExternalFilesDirs(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
[Android.Runtime.Register("getExternalFilesDirs", "(Ljava/lang/String;)[Ljava/io/File;", "GetGetExternalFilesDirs_Ljava_lang_String_Handler")]
public abstract Java.IO.File[]? GetExternalFilesDirs (string? type);[<Android.Runtime.Register("getExternalFilesDirs", "(Ljava/lang/String;)[Ljava/io/File;", "GetGetExternalFilesDirs_Ljava_lang_String_Handler")>]
abstract member GetExternalFilesDirs : string -> Java.IO.File[]Paramètres
- type
- 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 : android.os.Environment#DIRECTORY_MUSIC, , android.os.Environment#DIRECTORY_PODCASTSandroid.os.Environment#DIRECTORY_RINGTONES, , android.os.Environment#DIRECTORY_ALARMS, , android.os.Environment#DIRECTORY_NOTIFICATIONSandroid.os.Environment#DIRECTORY_PICTURES, ou android.os.Environment#DIRECTORY_MOVIES.
Retours
chemins absolus vers 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
Remarques
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() si ces fichiers seront supprimés lorsque l’application est désinstallée, mais il existe certaines différences importantes : <le stockage partagé ul><li>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 Environment#getExternalStorageState(File)de . <li>Il n’existe aucune sécurité appliquée avec ces fichiers. Par exemple, toute application contenant android.Manifest.permission#WRITE_EXTERNAL_STORAGE peut écrire dans ces fichiers. </ul>
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’y a pas d’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.
Documentation Java pour android.content.Context.getExternalFilesDirs(java.lang.String).
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.