语言

Context.GetExternalCacheDirs 方法

定义

返回所有共享/外部存储设备上特定于应用程序的目录的绝对路径,应用程序可以在其中放置其拥有的缓存文件。

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

返回

File[]

特定于应用程序的目录的绝对路径。 如果共享存储当前不可用,则可能是 null 某些单独的路径。 返回的第一个路径与 #getExternalCacheDir().

特性

注解

返回所有共享/外部存储设备上特定于应用程序的目录的绝对路径,应用程序可以在其中放置其拥有的缓存文件。 这些文件在应用程序内部,通常不向用户作为媒体可见。

这类似于 #getCacheDir() 在卸载应用程序时将删除这些文件,但存在一些重要差异: <ul><li>平台并不总是监视共享存储中可用的空间,因此可能不会自动删除这些文件。 应用应始终管理此位置使用的最大空间。 目前,平台将删除此处文件的唯一时间是在运行 android.os.Build.VERSION_CODES#JELLY_BEAN_MR1 或更高版本 Environment#isExternalStorageEmulated(File) 并返回 true 时。 <li>共享存储可能并不总是可用,因为用户可以弹出可移动媒体。 可以使用 .. 检查 Environment#getExternalStorageState(File)媒体状态。 <li>这些文件未强制实施安全。 例如,任何持有 android.Manifest.permission#WRITE_EXTERNAL_STORAGE 的应用程序都可以写入这些文件。 </ul>

如果模拟共享存储设备(由Environment#isExternalStorageEmulated(File)确定),则其内容由专用用户数据分区提供支持,这意味着在这里存储数据没有好处,而不是由专用目录返回。#getCacheDir()

此处返回的共享存储设备被视为设备的稳定部分,包括保护盖下的物理媒体槽。 返回的路径不包括暂时性设备,例如连接到手持设备的 USB 闪存驱动器。

应用程序可以在任何或所有返回的设备上存储数据。 例如,应用可以选择将大文件存储在具有最可用空间的设备上,以度量方式 StatFs。

调用应用无需其他权限即可在返回的路径下读取或写入文件。 辅助外部存储设备上的这些路径之外的写入访问权限不可用。

如果插入了不同的共享存储介质,则返回的路径可能会随时间而变化,因此应仅保留相对路径。

Java文档android.content.Context.getExternalCacheDirs()。

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

适用于

另请参阅