DocumentsContract.BuildDocumentUriUsingTree(Uri, String) 方法

定义

生成 URI,表示文档提供程序中的目标 Document#COLUMN_DOCUMENT_ID

[Android.Runtime.Register("buildDocumentUriUsingTree", "(Landroid/net/Uri;Ljava/lang/String;)Landroid/net/Uri;", "")]
public static Android.Net.Uri? BuildDocumentUriUsingTree (Android.Net.Uri? treeUri, string? documentId);
[<Android.Runtime.Register("buildDocumentUriUsingTree", "(Landroid/net/Uri;Ljava/lang/String;)Landroid/net/Uri;", "")>]
static member BuildDocumentUriUsingTree : Android.Net.Uri * string -> Android.Net.Uri

参数

treeUri
Uri

用于获取目标文档访问权限的子树。 目标目录必须是此子树的后代。

documentId
String

目标文档,调用方可能无权直接访问该文档。

返回

Uri
属性

注解

生成 URI,表示文档提供程序中的目标 Document#COLUMN_DOCUMENT_ID 。 查询时,提供程序将返回一行,其中包含由该 Document行定义的列。

但是,返回的 URI 将利用通过子树 URI 授予的访问权限,通常由 Intent#ACTION_OPEN_DOCUMENT_TREE该 URI 返回,而不是直接访问目标文档。 目标文档必须是子树的后代(子级、孙子等)。

这通常用于访问用户选择的目录树下的文档,因为它不需要用户单独确认每个新的文档访问。

适用于 . 的 android.provider.DocumentsContract.buildDocumentUriUsingTree(android.net.Uri, java.lang.String)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

另请参阅

  • ActionOpenDocumentTree
  • <xref:Android.Provider.DocumentsProvider.IsChildDocument(System.String%2c+System.String)>
  • <xref:Android.Provider.DocumentsContract.BuildDocumentUri(System.String%2c+System.String)>