Freigeben über


DocumentsContract.BuildDocumentUriUsingTree(Uri, String) Methode

Definition

Build-URI, der das Ziel Document#COLUMN_DOCUMENT_ID in einem Dokumentanbieter darstellt.

[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

Parameter

treeUri
Uri

die Unterstruktur, die verwendet werden soll, um Zugriff auf das Zieldokument zu erhalten. Das Zielverzeichnis muss ein untergeordnetes Element dieser Unterstruktur sein.

documentId
String

das Zieldokument, auf das der Aufrufer möglicherweise keinen direkten Zugriff hat.

Gibt zurück

Uri
Attribute

Hinweise

Build-URI, der das Ziel Document#COLUMN_DOCUMENT_ID in einem Dokumentanbieter darstellt. Wenn abgefragt wird, gibt ein Anbieter eine einzelne Zeile mit Spalten zurück, die durch definiert sind Document.

Anstatt jedoch direkt auf das Zieldokument zuzugreifen, nutzt der zurückgegebene URI den Zugriff, der über einen Unterstruktur-URI gewährt wird, normalerweise von Intent#ACTION_OPEN_DOCUMENT_TREE. Das Zieldokument muss ein untergeordnetes Element (untergeordnetes Element, Enkel usw.) der Unterstruktur sein.

Dies wird in der Regel für den Zugriff auf Dokumente unter einer vom Benutzer ausgewählten Verzeichnisstruktur verwendet, da der Benutzer nicht erforderlich ist, jeden neuen Dokumentzugriff separat zu bestätigen.

Java-Dokumentation für android.provider.DocumentsContract.buildDocumentUriUsingTree(android.net.Uri, java.lang.String).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

Weitere Informationen

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