DocumentsProvider.QuerySearchDocuments Método

[Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_Ljava_lang_String_arrayLjava_lang_String_Handler")]
public virtual Android.Database.ICursor? QuerySearchDocuments(string? rootId, string? query, string[]? projection);

[<Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_Ljava_lang_String_arrayLjava_lang_String_Handler")>]
abstract member QuerySearchDocuments : string * string * string[] -> Android.Database.ICursor
override this.QuerySearchDocuments : string * string * string[] -> Android.Database.ICursor

Parâmetros

Retornos

Atributos

RegisterAttribute

Exceções

Comentários

Retorne documentos que correspondam à consulta fornecida na raiz solicitada. Os documentos retornados devem ser classificados por relevância em ordem decrescente. Como os documentos são correspondidos com a cadeia de caracteres de consulta é um detalhe de implementação deixado para cada provedor, mas é sugerido que pelo menos Document#COLUMN_DISPLAY_NAME seja correspondido de forma que não diferencia maiúsculas de minúsculas.

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 dar suporte a notificações de alteração, você deve ter Cursor#setNotificationUri(ContentResolver, Uri) um Uri relevante, como DocumentsContract#buildSearchDocumentsUri(String, String, String). Em seguida, você pode ligar ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) com esse Uri para enviar notificações de alteração.

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

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

Confira também

• ExtraLoading
• ExtraInfo
• ExtraError

[Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Handler", ApiSince=29)]
public virtual Android.Database.ICursor? QuerySearchDocuments(string rootId, string[]? projection, Android.OS.Bundle queryArgs);

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

Parâmetros

Retornos

cursor que contém o resultado da pesquisa. Inclua ContentResolver#EXTRA_HONORED_ARGS em Cursor extras Bundle quando qualquer valor QUERY_ARG_* foi respeitado durante a preparação dos resultados.

Atributos

RegisterAttribute

Comentários

Retorne documentos que correspondam à consulta fornecida na raiz solicitada. Os documentos retornados devem ser classificados por relevância em ordem decrescente. Como os documentos são correspondidos com a cadeia de caracteres de consulta é um detalhe de implementação deixado para cada provedor, mas é sugerido que pelo menos Document#COLUMN_DISPLAY_NAME seja correspondido de forma que não diferencia maiúsculas de minúsculas.

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 dar suporte a notificações de alteração, você deve ter Cursor#setNotificationUri(ContentResolver, Uri) um Uri relevante, como DocumentsContract#buildSearchDocumentsUri(String, String, String). Em seguida, você pode ligar ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) com esse Uri para enviar notificações de alteração.

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

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