DocumentsContract.BuildDocumentUriUsingTree(Uri, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- 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.
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)>