StorageVolume.CreateAccessIntent(String) 方法

定义

生成一个意向,用于在获得用户的批准后授予对标准存储目录或整个卷的访问权限。

[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_RINGTONESEnvironment#DIRECTORY_ALARMSEnvironment#DIRECTORY_PICTURESEnvironment#DIRECTORY_NOTIFICATIONSEnvironment#DIRECTORY_DOWNLOADSEnvironment#DIRECTORY_MOVIESEnvironment#DIRECTORY_DCIMEnvironment#DIRECTORY_DOCUMENTS请求null访问整个卷之一Environment#DIRECTORY_MUSIC

返回

意图请求访问权限,或者 null 请求的目录是否对该卷无效。

属性

注解

生成一个意向,用于在获得用户的批准后授予对标准存储目录或整个卷的访问权限。

调用后,系统将要求用户授予对所请求目录(及其后代)的访问权限。 请求的结果将通过该方法返回到活动 onActivityResult

若要获取对后代(子级、孙子等)文档的访问权限,请使用 DocumentsContract#buildDocumentUriUsingTree(Uri, String)DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String) 返回的 URI。

如果应用程序只需要存储内部数据,请考虑使用Context#getExternalFilesDirs(String) Context.getExternalFilesDirsContext#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 属性许可证中所述的术语使用。

适用于