Compartilhar via


DocumentsContract.BuildDocumentUriUsingTree(Uri, String) Método

Definição

Criar URI representando o destino Document#COLUMN_DOCUMENT_ID em um provedor de documentos.

[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

Parâmetros

treeUri
Uri

a subárvore a ser aproveitada para obter acesso ao documento de destino. O diretório de destino deve ser um descendente dessa subárvore.

documentId
String

O documento de destino, ao qual o chamador pode não ter acesso direto.

Retornos

Uri
Atributos

Comentários

Criar URI representando o destino Document#COLUMN_DOCUMENT_ID em um provedor de documentos. Quando consultado, um provedor retornará uma única linha com colunas definidas por Document.

No entanto, em vez de acessar diretamente o documento de destino, o URI retornado aproveitará o acesso concedido por meio de um URI de subárvore, normalmente retornado pelo Intent#ACTION_OPEN_DOCUMENT_TREE. O documento de destino deve ser um descendente (filho, neto, etc) da subárvore.

Isso geralmente é usado para acessar documentos em uma árvore de diretórios selecionada pelo usuário, já que não exige que o usuário confirme separadamente cada novo acesso ao documento.

Documentação Java para android.provider.DocumentsContract.buildDocumentUriUsingTree(android.net.Uri, java.lang.String).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Aplica-se a

Confira também

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