ContextWrapper.GetExternalCacheDirs Méthode

Définition

Espace de noms:

Android.Content

Assembly:

Mono.Android.dll

Retourne des chemins absolus vers des répertoires spécifiques à l’application sur tous les appareils de stockage externes où l’application peut placer des fichiers de cache qu’elle possède.

[Android.Runtime.Register("getExternalCacheDirs", "()[Ljava/io/File;", "GetGetExternalCacheDirsHandler")]
public override Java.IO.File[]? GetExternalCacheDirs();

[<Android.Runtime.Register("getExternalCacheDirs", "()[Ljava/io/File;", "GetGetExternalCacheDirsHandler")>]
override this.GetExternalCacheDirs : unit -> Java.IO.File[]

Retours

File[]

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 de cache 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 getCacheDir() dans lequel ces fichiers seront supprimés lorsque l’application est désinstallée, mais il existe certaines différences importantes : la plateforme ne surveille pas toujours l’espace disponible dans le stockage partagé et peut donc ne pas supprimer automatiquement ces fichiers. Les applications doivent toujours gérer l’espace maximal utilisé dans cet emplacement. Actuellement, les seuls fichiers de temps ici seront supprimés par la plateforme lors de l’exécution sur Build.VERSION_CODES. JELLY_BEAN_MR1 ou version ultérieure et Environment.isExternalStorageEmulated(File) retourne true. 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 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’existe aucun avantage à stocker des données ici au lieu du répertoire privé retourné par getCacheDir(). 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. Les chemins retournés peuvent changer au fil du temps si différents supports de stockage partagé sont insérés, de sorte que seuls les chemins relatifs doivent être conservés. 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 getExternalCacheDir().

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.getExternalCacheDirs().