ContextWrapper.GetExternalMediaDirs Méthode

[Android.Runtime.Register("getExternalMediaDirs", "()[Ljava/io/File;", "GetGetExternalMediaDirsHandler")]
[System.Obsolete("deprecated")]
public override Java.IO.File[]? GetExternalMediaDirs();

[<Android.Runtime.Register("getExternalMediaDirs", "()[Ljava/io/File;", "GetGetExternalMediaDirsHandler")>]
[<System.Obsolete("deprecated")>]
override this.GetExternalMediaDirs : unit -> Java.IO.File[]

Retours

Cette méthode est déconseillée. Ces répertoires existent toujours et sont analysés, mais les développeurs sont encouragés à migrer vers l’insertion de contenu dans une collection MediaStore directement, car n’importe quelle application peut contribuer à un nouveau média dans MediaStore sans autorisations requises, à partir de Build.VERSION_CODES. Q . 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 multimédias. Ces fichiers sont analysés et mis à la disposition d’autres applications via MediaStore. C’est comme getExternalFilesDirs(String) 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. 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.

Attributs

RegisterAttribute ObsoleteAttribute

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