Langue

DocumentsProvider.QuerySearchDocuments Méthode

Définition

Surcharges

Nom Description
QuerySearchDocuments(String, String[], Bundle, CancellationSignal)

Retourne des documents qui correspondent à la requête donnée sous le répertoire demandé.

QuerySearchDocuments(String, String, String[], CancellationSignal)

Retourne des documents qui correspondent à la requête donnée sous le répertoire demandé.

QuerySearchDocuments(String, String, String[])

Retourne des documents qui correspondent à la requête donnée sous la racine demandée.

QuerySearchDocuments(String, String[], Bundle)

Retourne des documents qui correspondent à la requête donnée sous la racine demandée.

QuerySearchDocuments(String, String[], Bundle, CancellationSignal)

Retourne des documents qui correspondent à la requête donnée sous le répertoire demandé.

[Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Landroid_os_CancellationSignal_Handler", ApiSince=37)]
public virtual Android.Database.ICursor? QuerySearchDocuments(string parentDocumentId, string[]? projection, Android.OS.Bundle queryArgs, Android.OS.CancellationSignal? signal);
[<Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;[Ljava/lang/String;Landroid/os/Bundle;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_Bundle_Landroid_os_CancellationSignal_Handler", ApiSince=37)>]
abstract member QuerySearchDocuments : string * string[] * Android.OS.Bundle * Android.OS.CancellationSignal -> Android.Database.ICursor
override this.QuerySearchDocuments : string * string[] * Android.OS.Bundle * Android.OS.CancellationSignal -> Android.Database.ICursor

Paramètres

parentDocumentId
String

répertoire sous lequel effectuer une recherche.

projection
String[]

liste de Document colonnes à placer dans le curseur. Si null toutes les colonnes prises en charge doivent être incluses.

queryArgs
Bundle

arguments de requête. DocumentsContract#QUERY_ARG_EXCLUDE_MEDIA, , DocumentsContract#QUERY_ARG_DISPLAY_NAME, DocumentsContract#QUERY_ARG_MIME_TYPESDocumentsContract#QUERY_ARG_FILE_SIZE_OVER, , DocumentsContract#QUERY_ARG_LAST_MODIFIED_AFTER.

signal
CancellationSignal

utilisé par l’appelant pour signaler si la demande doit être annulée. Peut être null.

Retours

curseur contenant le résultat de la recherche. Incluez ContentResolver#EXTRA_HONORED_ARGS des Cursor extras Bundle quand une valeur QUERY_ARG_* a été respectée lors de la préparation des résultats.

Attributs

S’applique à

QuerySearchDocuments(String, String, String[], CancellationSignal)

Retourne des documents qui correspondent à la requête donnée sous le répertoire demandé.

[Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_CancellationSignal_Handler", ApiSince=37)]
public virtual Android.Database.ICursor? QuerySearchDocuments(string parentDocumentId, string query, string[]? projection, Android.OS.CancellationSignal? signal);
[<Android.Runtime.Register("querySearchDocuments", "(Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "GetQuerySearchDocuments_Ljava_lang_String_Ljava_lang_String_arrayLjava_lang_String_Landroid_os_CancellationSignal_Handler", ApiSince=37)>]
abstract member QuerySearchDocuments : string * string * string[] * Android.OS.CancellationSignal -> Android.Database.ICursor
override this.QuerySearchDocuments : string * string * string[] * Android.OS.CancellationSignal -> Android.Database.ICursor

Paramètres

parentDocumentId
String

répertoire sous lequel effectuer une recherche.

query
String

chaîne à laquelle faire correspondre les documents.

projection
String[]

liste de Document colonnes à placer dans le curseur. Si null toutes les colonnes prises en charge doivent être incluses.

signal
CancellationSignal

utilisé par l’appelant pour signaler si la demande doit être annulée. Peut être null.

Retours

Attributs

S’applique à

QuerySearchDocuments(String, String, String[])

Retourne des documents qui correspondent à la requête donnée sous la racine demandée.

[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

Paramètres

rootId
String

racine sous laquelle effectuer une recherche.

query
String

chaîne à laquelle faire correspondre les documents.

projection
String[]

liste de Document colonnes à placer dans le curseur. Si null toutes les colonnes prises en charge doivent être incluses.

Retours

Attributs

Exceptions

Remarques

Retourne des documents qui correspondent à la requête donnée sous la racine demandée. Les documents retournés doivent être triés par pertinence dans l’ordre décroissant. La façon dont les documents sont mis en correspondance avec la chaîne de requête est un détail d’implémentation laissé à chaque fournisseur, mais il est suggéré qu’au moins Document#COLUMN_DISPLAY_NAME être mis en correspondance de manière non sensible à la casse.

Si votre fournisseur est basé sur le cloud et que vous disposez de certaines données mises en cache ou épinglées localement, vous pouvez retourner immédiatement les données locales, en définissant DocumentsContract#EXTRA_LOADING sur le curseur pour indiquer que vous récupérez toujours des données supplémentaires. Ensuite, lorsque les données réseau sont disponibles, vous pouvez envoyer une notification de modification pour déclencher une nouvelle requête et retourner le contenu complet.

Pour prendre en charge les notifications de modification, vous devez Cursor#setNotificationUri(ContentResolver, Uri) utiliser un URI approprié, tel que DocumentsContract#buildSearchDocumentsUri(String, String, String). Vous pouvez ensuite appeler ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) avec cet URI pour envoyer des notifications de modification.

Java documentation pour android.provider.DocumentsProvider.querySearchDocuments(java.lang.String, java.lang.String, java.lang.String[]).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Voir aussi

S’applique à

QuerySearchDocuments(String, String[], Bundle)

Retourne des documents qui correspondent à la requête donnée sous la racine demandée.

[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

Paramètres

rootId
String

racine sous laquelle effectuer une recherche.

projection
String[]

liste de Document colonnes à placer dans le curseur. Si null toutes les colonnes prises en charge doivent être incluses.

queryArgs
Bundle

arguments de requête. DocumentsContract#QUERY_ARG_EXCLUDE_MEDIA, , DocumentsContract#QUERY_ARG_DISPLAY_NAME, DocumentsContract#QUERY_ARG_MIME_TYPESDocumentsContract#QUERY_ARG_FILE_SIZE_OVER, , DocumentsContract#QUERY_ARG_LAST_MODIFIED_AFTER.

Retours

curseur contenant le résultat de la recherche. Incluez ContentResolver#EXTRA_HONORED_ARGS des Cursor extras Bundle quand une valeur QUERY_ARG_* a été respectée lors de la préparation des résultats.

Attributs

Remarques

Retourne des documents qui correspondent à la requête donnée sous la racine demandée. Les documents retournés doivent être triés par pertinence dans l’ordre décroissant. La façon dont les documents sont mis en correspondance avec la chaîne de requête est un détail d’implémentation laissé à chaque fournisseur, mais il est suggéré qu’au moins Document#COLUMN_DISPLAY_NAME être mis en correspondance de manière non sensible à la casse.

Si votre fournisseur est basé sur le cloud et que vous disposez de certaines données mises en cache ou épinglées localement, vous pouvez retourner immédiatement les données locales, en définissant DocumentsContract#EXTRA_LOADING sur le curseur pour indiquer que vous récupérez toujours des données supplémentaires. Ensuite, lorsque les données réseau sont disponibles, vous pouvez envoyer une notification de modification pour déclencher une nouvelle requête et retourner le contenu complet.

Pour prendre en charge les notifications de modification, vous devez Cursor#setNotificationUri(ContentResolver, Uri) utiliser un URI approprié, tel que DocumentsContract#buildSearchDocumentsUri(String, String, String). Vous pouvez ensuite appeler ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) avec cet URI pour envoyer des notifications de modification.

Java documentation pour android.provider.DocumentsProvider.querySearchDocuments(java.lang.String, java.lang.String[], android.os.Bundle).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à