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 сборки, представляющий целевой объект Document#COLUMN_DOCUMENT_ID
в поставщике документов. При запросе поставщик вернет одну строку со столбцами, определенными Document
.
Однако вместо прямого доступа к целевому документу возвращенный универсальный код ресурса (URI) будет использовать доступ, предоставленный через URI поддерев, который обычно возвращается Intent#ACTION_OPEN_DOCUMENT_TREE
. Целевой документ должен быть потомком (дочерним, внуком и т. д.) поддерев.
Обычно это используется для доступа к документам в дереве каталога, выбранном пользователем, так как пользователю не требуется отдельно подтвердить доступ к каждому новому документу.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.
Применяется к
См. также раздел
- ActionOpenDocumentTree
- <xref:Android.Provider.DocumentsProvider.IsChildDocument(System.String%2c+System.String)>
- <xref:Android.Provider.DocumentsContract.BuildDocumentUri(System.String%2c+System.String)>