Environment.ExternalStorageDirectory Propriété
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.
Retournez le répertoire de stockage principal partagé/externe.
public static Java.IO.File? ExternalStorageDirectory { [Android.Runtime.Register("getExternalStorageDirectory", "()Ljava/io/File;", "")] get; }[<get: Android.Runtime.Register("getExternalStorageDirectory", "()Ljava/io/File;", "")>]
static member ExternalStorageDirectory : Java.IO.FileValeur de propriété
Valeur du répertoire de stockage externe.
- Attributs
Remarques
Retournez le répertoire de stockage principal partagé/externe. Ce répertoire peut ne pas être accessible actuellement s’il a été monté par l’utilisateur sur son ordinateur, a été supprimé de l’appareil, ou un autre problème s’est produit. Vous pouvez déterminer son état actuel avec #getExternalStorageState().
<em>Remarque : ne pas être confondu par le mot « externe » ici. Ce répertoire peut mieux être considéré comme un stockage multimédia/partagé. Il s’agit d’un système de fichiers qui peut contenir une quantité relativement importante de données et qui est partagée entre toutes les applications (n’applique pas les autorisations). Traditionnellement, il s’agit d’une carte SD, mais elle peut également être implémentée en tant que stockage intégré dans un appareil distinct du stockage interne protégé et peut être monté en tant que système de fichiers sur un ordinateur.</em>
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.
Dans les appareils avec plusieurs répertoires de stockage partagé/externe, ce répertoire représente le stockage principal avec lequel l’utilisateur interagit. L’accès au stockage secondaire est disponible via Context#getExternalFilesDirs(String), Context#getExternalCacheDirs()et Context#getExternalMediaDirs().
Les applications ne doivent pas utiliser directement ce répertoire de niveau supérieur pour éviter de polluer l’espace de noms racine de l’utilisateur. Tous les fichiers privés de l’application doivent être placés dans un répertoire retourné par android.content.Context#getExternalFilesDir Context.getExternalFilesDir, par lequel le système s’occupe de la suppression si l’application est désinstallée. D’autres fichiers partagés doivent être placés dans l’un des répertoires retournés par #getExternalStoragePublicDirectory.
L’écriture dans ce chemin nécessite l’autorisation android.Manifest.permission#WRITE_EXTERNAL_STORAGE et le démarrage, l’accès en android.os.Build.VERSION_CODES#KITKATlecture nécessite l’autorisation android.Manifest.permission#READ_EXTERNAL_STORAGE , qui est automatiquement accordée si vous conservez l’autorisation d’écriture.
android.os.Build.VERSION_CODES#KITKATÀ compter de , si votre application doit uniquement stocker des données internes, envisagez d’utiliser Context#getExternalFilesDir(String), Context#getExternalCacheDir()ou , ou Context#getExternalMediaDirs(), qui ne nécessitent aucune autorisation de lecture ou d’écriture.
Ce chemin peut changer entre les versions de la plateforme. Les applications doivent donc conserver uniquement les chemins relatifs.
Voici un exemple de code classique pour surveiller l’état du stockage externe :
{
Java documentation pour android.os.Environment.getExternalStorageDirectory().
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.