語言

DocumentsContract.BuildDocumentUriUsingTree(Uri, String) 方法

定義

命名空間:
Android.Provider
組件:
Mono.Android.dll

建立代表目標 Document#COLUMN_DOCUMENT_ID 的文件提供者的 URI。

[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 存取目標文件的 URI。

屬性
RegisterAttribute

備註

建立代表目標 Document#COLUMN_DOCUMENT_ID 的文件提供者的 URI。 當查詢時，提供者會回傳一列，欄位由 定義為 Document。

然而，回傳的 URI 並非直接存取目標文件，而是利用子樹 URI 所授予的存取權限，通常由 Intent#ACTION_OPEN_DOCUMENT_TREE返回。 目標文件必須是子樹的後代（子節點、孫子等）。

這通常用於使用者選擇目錄樹下的存取文件，因為使用者不需要分別確認每個新文件存取。

Java 文件 android.provider.DocumentsContract.buildDocumentUriUsingTree(android.net.Uri, java.lang.String)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

另請參閱

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