DocumentsProvider.QueryChildDocuments Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| QueryChildDocuments(String, String[], Bundle) |
Eseguire l'override di questo metodo per restituire i documenti figlio contenuti nella directory richiesta. |
| QueryChildDocuments(String, String[], String) |
Restituisce i documenti figlio contenuti nella directory richiesta. |
QueryChildDocuments(String, String[], Bundle)
Eseguire l'override di questo metodo per restituire i documenti figlio contenuti nella directory richiesta.
[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
Parametri
- parentDocumentId
- String
directory per cui restituire elementi figlio.
- projection
- String[]
elenco di Document colonne da inserire nel cursore. Se null devono essere incluse tutte le colonne supportate.
- queryArgs
- Bundle
Bundle contenente informazioni di ordinamento o altri argomenti utili per il provider. Se non sono disponibili informazioni di ordinamento, verrà usato l'ordinamento predefinito, che potrebbe non essere ordinato. Per informazioni dettagliate, vedere ContentResolver#QUERY_ARG_SORT_COLUMNS.
Valori restituiti
- Attributi
Commenti
Eseguire l'override di questo metodo per restituire i documenti figlio contenuti nella directory richiesta. Questo deve restituire solo discendenti immediati.
Se il provider è basato sul cloud e i dati sono memorizzati nella cache in locale, è possibile restituire immediatamente i dati locali, impostando DocumentsContract#EXTRA_LOADING su Cursor extra per indicare che si stanno ancora recuperando dati aggiuntivi. Quindi, quando i dati di rete sono disponibili, è possibile inviare una notifica di modifica per attivare una query e restituire il contenuto completo. Per restituire un cursore con elementi aggiuntivi, è necessario estendere ed eseguire l'override Cursor#getExtras()di .
Per supportare le notifiche di modifica, è necessario Cursor#setNotificationUri(ContentResolver, Uri) disporre di un URI pertinente, ad esempio DocumentsContract#buildChildDocumentsUri(String, String). È quindi possibile chiamare ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) con tale URI per inviare notifiche di modifica.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.
Si applica a
QueryChildDocuments(String, String[], String)
Restituisce i documenti figlio contenuti nella directory richiesta.
[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
Parametri
- parentDocumentId
- String
directory per cui restituire elementi figlio.
- projection
- String[]
elenco di Document colonne da inserire nel cursore. Se null devono essere incluse tutte le colonne supportate.
- sortOrder
- String
come ordinare le righe, formattate come clausola SQL ORDER BY (escluso order BY).
Il passaggio null userà l'ordinamento predefinito, che può essere non ordinato. Questo ordinamento è un suggerimento che può essere usato per classificare in ordine di priorità il recupero dei dati dalla rete, ma l'interfaccia utente può sempre applicare un ordine specifico.
Valori restituiti
- Attributi
Eccezioni
Commenti
Restituisce i documenti figlio contenuti nella directory richiesta. Questa operazione deve restituire solo discendenti immediati, perché verranno eseguite query aggiuntive per esplorare in modo ricorsivo l'albero.
Le app destinate android.os.Build.VERSION_CODES#O o superiori devono eseguire l'override di #queryChildDocuments(String, String[], Bundle).
Se il provider è basato sul cloud e si dispone di alcuni dati memorizzati nella cache o aggiunti in locale, è possibile restituire immediatamente i dati locali, impostando DocumentsContract#EXTRA_LOADING su Cursor per indicare che si stanno ancora recuperando dati aggiuntivi. Quindi, quando i dati di rete sono disponibili, è possibile inviare una notifica di modifica per attivare una query e restituire il contenuto completo. Per restituire un cursore con elementi aggiuntivi, è necessario estendere ed eseguire l'override Cursor#getExtras()di .
Per supportare le notifiche di modifica, è necessario Cursor#setNotificationUri(ContentResolver, Uri) disporre di un URI pertinente, ad esempio DocumentsContract#buildChildDocumentsUri(String, String). È quindi possibile chiamare ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) con tale URI per inviare notifiche di modifica.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.