Android.Provider.DocumentsContract.BuildDocumentUriUsingTree Method
Build URI representing the target NoType:android/provider/DocumentsContract$Document;Href=../../../reference/android/provider/DocumentsContract.Document.html#COLUMN_DOCUMENT_ID in a document provider.

Syntax

[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)

See Also

Android.Content.Intent.ActionOpenDocumentTree
DocumentsProvider.IsChildDocument(string, System.String)
DocumentsContract.BuildDocumentUri(string, System.String)

Parameters

treeUri
the subtree to leverage to gain access to the target document. The target directory must be a descendant of this subtree.
documentId
the target document, which the caller may not have direct access to.

Returns

Documentation for this section has not yet been entered.

Remarks

Build URI representing the target NoType:android/provider/DocumentsContract$Document;Href=../../../reference/android/provider/DocumentsContract.Document.html#COLUMN_DOCUMENT_ID in a document provider. When queried, a provider will return a single row with columns defined by NoType:android/provider/DocumentsContract$Document;Href=../../../reference/android/provider/DocumentsContract.Document.html.

However, instead of directly accessing the target document, the returned URI will leverage access granted through a subtree URI, typically returned by Android.Content.Intent.ActionOpenDocumentTree. The target document must be a descendant (child, grandchild, etc) of the subtree.

This is typically used to access documents under a user-selected directory tree, since it doesn't require the user to separately confirm each new document access.

[Android Documentation]

Requirements

Namespace: Android.Provider
Assembly: Mono.Android (in Mono.Android.dll)
Assembly Versions: 0.0.0.0