DocumentsProvider.QuerySearchDocuments Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
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.
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.