StorageVolume.CreateAccessIntent(String) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
生成一个意向,用于在获得用户的批准后授予对标准存储目录或整个卷的访问权限。
[Android.Runtime.Register("createAccessIntent", "(Ljava/lang/String;)Landroid/content/Intent;", "", ApiSince=24)]
public Android.Content.Intent? CreateAccessIntent (string? directoryName);
[<Android.Runtime.Register("createAccessIntent", "(Ljava/lang/String;)Landroid/content/Intent;", "", ApiSince=24)>]
member this.CreateAccessIntent : string -> Android.Content.Intent
参数
- directoryName
- String
必须是、Environment#DIRECTORY_PODCASTS
、、、Environment#DIRECTORY_RINGTONES
、Environment#DIRECTORY_ALARMS
Environment#DIRECTORY_PICTURES
Environment#DIRECTORY_NOTIFICATIONS
、Environment#DIRECTORY_DOWNLOADS
Environment#DIRECTORY_MOVIES
、Environment#DIRECTORY_DCIM
或Environment#DIRECTORY_DOCUMENTS
请求null
访问整个卷之一Environment#DIRECTORY_MUSIC
。
返回
意图请求访问权限,或者 null
请求的目录是否对该卷无效。
- 属性
注解
生成一个意向,用于在获得用户的批准后授予对标准存储目录或整个卷的访问权限。
调用后,系统将要求用户授予对所请求目录(及其后代)的访问权限。 请求的结果将通过该方法返回到活动 onActivityResult
。
若要获取对后代(子级、孙子等)文档的访问权限,请使用 DocumentsContract#buildDocumentUriUsingTree(Uri, String)
或 DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String)
返回的 URI。
如果应用程序只需要存储内部数据,请考虑使用Context#getExternalFilesDirs(String) Context.getExternalFilesDirs
或Context#getExternalCacheDirs()
Context#getExternalMediaDirs()
不需要读取或写入权限。
对整个卷的访问仅适用于非主要卷(对于主卷,应用可以使用和android.Manifest.permission#WRITE_EXTERNAL_STORAGE
权限),并且应谨慎使用android.Manifest.permission#READ_EXTERNAL_STORAGE
,因为当用户要求访问整个卷而不是特定目录时更有可能拒绝访问。
此成员已弃用。 呼叫者应改为迁移到使用 Intent#ACTION_OPEN_DOCUMENT_TREE
。 在运行android.os.Build.VERSION_CODES#Q
或更高版本的设备上启动此功能Intent
将立即完成结果代码。android.app.Activity#RESULT_CANCELED
适用于 . 的 android.os.storage.StorageVolume.createAccessIntent(java.lang.String)
Java 文档
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。