Share via

DocumentsProvider.QuerySearchDocuments Método

  • Referencia

Definición

Espacio de nombres:
Android.Provider
Ensamblado:
Mono.Android.dll

Sobrecargas

QuerySearchDocuments(String, String, String[])

Devuelve documentos que coinciden con la consulta especificada en la raíz solicitada.
QuerySearchDocuments(String, String[], Bundle)

Devuelve documentos que coinciden con la consulta especificada en la raíz solicitada.

QuerySearchDocuments(String, String, String[])

Devuelve documentos que coinciden con la consulta especificada en la raíz solicitada.

[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

rootId
String

raíz en la que se va a buscar.

query
String

cadena con la que se va a buscar coincidencias con los documentos.

projection
String[]

lista de Document columnas que se van a colocar en el cursor. Si null se deben incluir todas las columnas admitidas.

Devoluciones

ICursor
Atributos
RegisterAttribute

Excepciones

FileNotFoundException

Comentarios

Devuelve documentos que coinciden con la consulta especificada en la raíz solicitada. Los documentos devueltos deben ordenarse por relevancia en orden descendente. El modo en que los documentos se comparan con la cadena de consulta es un detalle de implementación que queda a cada proveedor, pero se recomienda que al menos Document#COLUMN_DISPLAY_NAME coincidan de manera que no distinguen mayúsculas de minúsculas.

Si el proveedor está basado en la nube y tiene algunos datos almacenados en caché o anclados localmente, puede devolver los datos locales inmediatamente, estableciendo DocumentsContract#EXTRA_LOADING en el cursor para indicar que sigue capturando datos adicionales. A continuación, cuando los datos de red estén disponibles, puede enviar una notificación de cambio para desencadenar una nueva consulta y devolver el contenido completo.

Para admitir las notificaciones de cambio, debe Cursor#setNotificationUri(ContentResolver, Uri) tener un URI pertinente, como DocumentsContract#buildSearchDocumentsUri(String, String, String). A continuación, puede llamar ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) a con ese URI para enviar notificaciones de cambio.

Documentación de Java para android.provider.DocumentsProvider.querySearchDocuments(java.lang.String, java.lang.String, java.lang.String[]).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código y se usan según los términos descritos en la creative Commons 2.5.

Consulte también

Se aplica a

QuerySearchDocuments(String, String[], Bundle)

Devuelve documentos que coinciden con la consulta especificada en la raíz solicitada.

[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

rootId
String

raíz en la que se va a buscar.

projection
String[]

lista de Document columnas que se van a colocar en el cursor. Si null se deben incluir todas las columnas admitidas.

queryArgs
Bundle

argumentos de consulta. DocumentsContract#QUERY_ARG_EXCLUDE_MEDIA, DocumentsContract#QUERY_ARG_DISPLAY_NAME, DocumentsContract#QUERY_ARG_MIME_TYPES, DocumentsContract#QUERY_ARG_FILE_SIZE_OVER, DocumentsContract#QUERY_ARG_LAST_MODIFIED_AFTER.

Devoluciones

ICursor

cursor que contiene el resultado de la búsqueda. Incluya ContentResolver#EXTRA_HONORED_ARGS en Cursor extras Bundle cuando se respeta cualquier valor de QUERY_ARG_* durante la preparación de los resultados.

Atributos
RegisterAttribute

Comentarios

Devuelve documentos que coinciden con la consulta especificada en la raíz solicitada. Los documentos devueltos deben ordenarse por relevancia en orden descendente. El modo en que los documentos se comparan con la cadena de consulta es un detalle de implementación que queda a cada proveedor, pero se recomienda que al menos Document#COLUMN_DISPLAY_NAME coincidan de manera que no distinguen mayúsculas de minúsculas.

Si el proveedor está basado en la nube y tiene algunos datos almacenados en caché o anclados localmente, puede devolver los datos locales inmediatamente, estableciendo DocumentsContract#EXTRA_LOADING en el cursor para indicar que sigue capturando datos adicionales. A continuación, cuando los datos de red estén disponibles, puede enviar una notificación de cambio para desencadenar una nueva consulta y devolver el contenido completo.

Para admitir las notificaciones de cambio, debe Cursor#setNotificationUri(ContentResolver, Uri) tener un URI pertinente, como DocumentsContract#buildSearchDocumentsUri(String, String, String). A continuación, puede llamar ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) a con ese URI para enviar notificaciones de cambio.

Documentación de Java para android.provider.DocumentsProvider.querySearchDocuments(java.lang.String, java.lang.String[], android.os.Bundle).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código y se usan según los términos descritos en la creative Commons 2.5.

Se aplica a