Context.GetExternalFilesDir(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 le chemin absolu du répertoire sur l’appareil de stockage principal partagé/externe où l’application peut placer des fichiers persistants qu’elle possède.
[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.FileParamè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
chemin absolu du répertoire spécifique à l’application. Peut retourner null si le stockage partagé n’est pas disponible actuellement.
- Attributs
Remarques
Retourne le chemin absolu du répertoire sur l’appareil de stockage principal partagé/externe où l’application peut placer des fichiers persistants qu’elle possède. Ces fichiers sont internes aux applications et ne sont généralement pas visibles par l’utilisateur en tant que supports.
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 appareil 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.
android.os.Build.VERSION_CODES#KITKATÀ compter de , aucune autorisation n’est requise pour lire ou écrire dans le chemin d’accès retourné ; elle est toujours accessible à l’application appelante. Cela s’applique uniquement aux chemins générés pour le nom du package de l’application appelante. Pour accéder aux chemins d’accès appartenant à d’autres packages android.Manifest.permission#WRITE_EXTERNAL_STORAGE et/ou android.Manifest.permission#READ_EXTERNAL_STORAGE sont requis.
Sur les appareils avec plusieurs utilisateurs (comme décrit par), UserManagerchaque utilisateur a son propre stockage partagé isolé. Les applications ont uniquement accès au stockage partagé pour l’utilisateur sous lequel elles s’exécutent.
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.
Voici un exemple de code classique pour manipuler un fichier dans le stockage partagé d’une application :
{
Java documentation pour android.content.Context.getExternalFilesDir(java.lang.String).
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.