DocumentsProvider.QueryChildDocuments Método

Definição

Namespace:: Android.Provider

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

Nome	Description
QueryChildDocuments(String, String[], Bundle)	Substitua esse método para retornar os documentos filhos contidos no diretório solicitado.
QueryChildDocuments(String, String[], String)	Retorne os documentos filhos contidos no diretório solicitado.

QueryChildDocuments(String, String[], Bundle)

Substitua esse método para retornar os documentos filhos contidos no diretório solicitado.

[Android.Runtime.Register("queryChildDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;)Landroid/database/Cursor;", "GetQueryChildDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Handler", ApiSince=26)]
public virtual Android.Database.ICursor? QueryChildDocuments(string? parentDocumentId, string[]? projection, Android.OS.Bundle? queryArgs);

[<Android.Runtime.Register("queryChildDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;)Landroid/database/Cursor;", "GetQueryChildDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Handler", ApiSince=26)>]
abstract member QueryChildDocuments : string * string[] * Android.OS.Bundle -> Android.Database.ICursor
override this.QueryChildDocuments : string * string[] * Android.OS.Bundle -> Android.Database.ICursor

Parâmetros

parentDocumentId: String

o diretório para o qual retornar os filhos.

projection: String[]

lista de Document colunas a serem colocadas no cursor. Se null todas as colunas com suporte devem ser incluídas.

queryArgs: Bundle

Pacote que contém informações de classificação ou outro argumento útil para o provedor. Se nenhuma informação de classificação estiver disponível, a classificação padrão será usada, o que pode não ser ordenado. Consulte ContentResolver#QUERY_ARG_SORT_COLUMNS para obter detalhes.

Retornos

ICursor

Atributos: RegisterAttribute

Comentários

Substitua esse método para retornar os documentos filhos contidos no diretório solicitado. Isso deve retornar somente descendentes imediatos.

Se o provedor for baseado em nuvem e você tiver dados armazenados em cache localmente, você poderá retornar os dados locais imediatamente, configurando DocumentsContract#EXTRA_LOADING nos extras do Cursor para indicar que você ainda está buscando dados adicionais. Em seguida, quando os dados de rede estiverem disponíveis, você poderá enviar uma notificação de alteração para disparar uma solicitação e retornar o conteúdo completo. Para retornar um Cursor com extras, você precisa estender e substituir Cursor#getExtras().

Para dar suporte a notificações de alteração, você deve ter Cursor#setNotificationUri(ContentResolver, Uri) um Uri relevante, como DocumentsContract#buildChildDocumentsUri(String, String). Em seguida, você pode ligar ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) com esse Uri para enviar notificações de alteração.

Java documentação para android.provider.DocumentsProvider.queryChildDocuments(java.lang.String, java.lang.String[], android.os.Bundle).

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

Aplica-se a

QueryChildDocuments(String, String[], String)

Retorne os documentos filhos contidos no diretório solicitado.

[Android.Runtime.Register("queryChildDocuments", "(Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;", "GetQueryChildDocuments_Ljava_lang_String_arrayLjava_lang_String_Ljava_lang_String_Handler")]
public abstract Android.Database.ICursor? QueryChildDocuments(string? parentDocumentId, string[]? projection, string? sortOrder);

[<Android.Runtime.Register("queryChildDocuments", "(Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;", "GetQueryChildDocuments_Ljava_lang_String_arrayLjava_lang_String_Ljava_lang_String_Handler")>]
abstract member QueryChildDocuments : string * string[] * string -> Android.Database.ICursor

Parâmetros

parentDocumentId: String

o diretório para o qual retornar os filhos.

projection: String[]

lista de Document colunas a serem colocadas no cursor. Se null todas as colunas com suporte devem ser incluídas.

sortOrder: String

como ordenar as linhas, formatadas como uma cláusula SQL ORDER BY (excluindo a ORDEM POR si só). A passagem null usará a ordem de classificação padrão, que pode não ser ordenada. Essa ordenação é uma dica que pode ser usada para priorizar como os dados são obtidos da rede, mas a interface do usuário sempre pode impor uma ordenação específica.

Retornos

ICursor

Atributos: RegisterAttribute

Exceções

FileNotFoundException

Comentários

Retorne os documentos filhos contidos no diretório solicitado. Isso só deve retornar descendentes imediatos, pois consultas adicionais serão emitidas para explorar recursivamente a árvore.

Os aplicativos direcionados android.os.Build.VERSION_CODES#O ou superiores devem substituir #queryChildDocuments(String, String[], Bundle).

Se o provedor for baseado em nuvem e você tiver alguns dados armazenados em cache ou fixados localmente, você poderá retornar os dados locais imediatamente, configurando DocumentsContract#EXTRA_LOADING no Cursor para indicar que você ainda está buscando dados adicionais. Em seguida, quando os dados de rede estiverem disponíveis, você poderá enviar uma notificação de alteração para disparar uma solicitação e retornar o conteúdo completo. Para retornar um Cursor com extras, você precisa estender e substituir Cursor#getExtras().

Java documentação para android.provider.DocumentsProvider.queryChildDocuments(java.lang.String, java.lang.String[], java.lang.String).

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

Confira também

Aplica-se a