ContextWrapper.GetExternalMediaDirs 方法

定义

命名空间:

Android.Content

程序集:

Mono.Android.dll

注意

deprecated

返回应用程序可在其中放置媒体文件的所有外部存储设备上特定于应用程序的目录的绝对路径。

[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[]

返回

File[]

不推荐使用此方法。 这些目录仍然存在并已扫描，但鼓励开发人员直接迁移到 MediaStore 集合中插入内容，因为任何应用都可以向 MediaStore 贡献新媒体，而无需任何权限，从Build.VERSION_CODES开始。Q . 返回应用程序可在其中放置媒体文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。 这些文件通过 MediaStore 扫描并提供给其他应用。 这类似于 getExternalFilesDirs（String），因为卸载应用程序时会删除这些文件，但存在一些重要差异：共享存储可能并不总是可用，因为用户可以弹出可移动媒体。 可以使用 Environment.getExternalStorageState（File） 检查媒体状态。 这些文件没有强制实施安全性。 例如，保存Manifest.permission.WRITE_EXTERNAL_STORAGE的任何应用程序都可以写入这些文件。 此处返回的共享存储设备被视为设备的稳定部分，包括保护盖下的物理媒体槽。 返回的路径不包括暂时性设备，例如连接到手持设备的 USB 闪存驱动器。 应用程序可以在任何或所有返回的设备上存储数据。 例如，应用可以选择将大文件存储在具有最可用空间的设备上，由 StatFs 测量。 调用应用无需其他权限即可在返回的路径下读取或写入文件。 辅助外部存储设备上的这些路径之外的写入访问权限不可用。 如果插入了不同的共享存储介质，则返回的路径可能会随时间而变化，因此应仅保留相对路径。 返回 File[] 特定于应用程序的目录的绝对路径。 如果共享存储当前不可用，则某些单独的路径可能为 null。

属性

RegisterAttribute ObsoleteAttribute

注解

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。

Java文档android.content.ContextWrapper.getExternalMediaDirs()。