DocumentsProvider.QueryChildDocuments Méthode

Définition

Espace de noms:: Android.Provider

Assembly:: Mono.Android.dll

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
QueryChildDocuments(String, String[], Bundle)	Remplacez cette méthode pour renvoyer les documents enfants contenus dans le répertoire demandé.
QueryChildDocuments(String, String[], String)	Retournez les documents enfants contenus dans le répertoire demandé.

QueryChildDocuments(String, String[], Bundle)

Remplacez cette méthode pour renvoyer les documents enfants contenus dans le répertoire demandé.

[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

Paramètres

parentDocumentId: String

répertoire pour lequel retourner des enfants.

projection: String[]

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

queryArgs: Bundle

Bundle contenant des informations de tri ou d’autres arguments utiles au fournisseur. Si aucune information de tri n’est disponible, le tri par défaut sera utilisé, ce qui peut être non ordonné. Pour plus d’informations, consultez ContentResolver#QUERY_ARG_SORT_COLUMNS.

Retours

ICursor

Attributs: RegisterAttribute

Remarques

Remplacez cette méthode pour renvoyer les documents enfants contenus dans le répertoire demandé. Cela ne doit retourner que les descendants immédiats.

Si votre fournisseur est basé sur le cloud et que vous disposez de données mises en cache localement, vous pouvez retourner immédiatement les données locales, en définissant DocumentsContract#EXTRA_LOADING des extras de 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 retourner un curseur avec des extras, vous devez étendre et remplacer Cursor#getExtras().

Pour prendre en charge les notifications de modification, vous devez Cursor#setNotificationUri(ContentResolver, Uri) utiliser un URI approprié, tel que DocumentsContract#buildChildDocumentsUri(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.queryChildDocuments(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 à

QueryChildDocuments(String, String[], String)

Retournez les documents enfants contenus dans le répertoire demandé.

[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

Paramètres

parentDocumentId: String

répertoire pour lequel retourner des enfants.

projection: String[]

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

sortOrder: String

comment classer les lignes, mises en forme en tant que clause SQL ORDER BY (à l’exclusion de ORDER BY lui-même). La transmission null utilise l’ordre de tri par défaut, qui peut être non ordonné. Cet ordre est un indicateur qui peut être utilisé pour hiérarchiser la façon dont les données sont extraites du réseau, mais l’interface utilisateur peut toujours appliquer un ordre spécifique.

Retours

ICursor

Attributs: RegisterAttribute

Exceptions

FileNotFoundException

Remarques

Retournez les documents enfants contenus dans le répertoire demandé. Cela ne doit retourner que les descendants immédiats, car des requêtes supplémentaires seront émises pour explorer l’arborescence de manière récursive.

Les applications ciblant android.os.Build.VERSION_CODES#O ou supérieure doivent remplacer #queryChildDocuments(String, String[], Bundle).

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 retourner un curseur avec des extras, vous devez étendre et remplacer Cursor#getExtras().

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

Voir aussi

S’applique à