語言

DocumentsContract.BuildChildDocumentsUriUsingTree(Uri, String) 方法

定義

建立一個 URI,代表文件提供者中目標目錄的子節點。

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

參數

treeUri
Uri

利用子樹來取得目標文件的存取權。 目標目錄必須是該子樹的後代。

parentDocumentId
String

要回傳子文件,呼叫者可能無法直接存取,且必須是具有 MIME 類型 Document#MIME_TYPE_DIR的目錄。

傳回

Uri

一個透過樹狀 URI 存取目標目錄子節點的 URI。

屬性

備註

建立一個 URI,代表文件提供者中目標目錄的子節點。 查詢時,提供者會回傳零列或多個欄位定義為 Document。

然而,回傳的 URI 不會直接存取目標目錄,而是利用子樹 URI 所授予的存取權限,通常由 返回。Intent#ACTION_OPEN_DOCUMENT_TREE 目標目錄必須是子樹的後代(子節點、孫子節點等)。

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

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

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

適用於

另請參閱

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