DocumentsProvider.QueryChildDocuments Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Nombre | Description |
|---|---|
| QueryChildDocuments(String, String[], Bundle) |
Invalide este método para devolver los documentos secundarios contenidos en el directorio solicitado. |
| QueryChildDocuments(String, String[], String) |
Devuelve los documentos secundarios incluidos en el directorio solicitado. |
QueryChildDocuments(String, String[], Bundle)
Invalide este método para devolver los documentos secundarios contenidos en el directorio solicitado.
[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.ICursorParámetros
- parentDocumentId
- String
el directorio para el que se van a devolver elementos secundarios.
- 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
Agrupación que contiene información de ordenación u otro argumento útil para el proveedor. Si no hay información de ordenación disponible, se usará la ordenación predeterminada, que puede no ordenarse. Consulte ContentResolver#QUERY_ARG_SORT_COLUMNS para obtener más información.
Devoluciones
- Atributos
Comentarios
Invalide este método para devolver los documentos secundarios contenidos en el directorio solicitado. Esto solo debe devolver descendientes inmediatos.
Si el proveedor está basado en la nube y tiene datos almacenados en caché localmente, puede devolver los datos locales inmediatamente, estableciendo DocumentsContract#EXTRA_LOADING en Cursor extras 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 devolver un cursor con extras, debe extender e invalidar Cursor#getExtras().
Para admitir las notificaciones de cambio, debe Cursor#setNotificationUri(ContentResolver, Uri) tener un URI pertinente, como DocumentsContract#buildChildDocumentsUri(String, String). A continuación, puede llamar ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) a con ese URI para enviar notificaciones de cambio.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Se aplica a
QueryChildDocuments(String, String[], String)
Devuelve los documentos secundarios incluidos en el directorio solicitado.
[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.ICursorParámetros
- parentDocumentId
- String
el directorio para el que se van a devolver elementos secundarios.
- projection
- String[]
lista de Document columnas que se van a colocar en el cursor. Si null se deben incluir todas las columnas admitidas.
- sortOrder
- String
cómo ordenar las filas, con el formato de una cláusula SQL ORDER BY (excepto el propio ORDER BY).
Pasar null usará el criterio de ordenación predeterminado, que puede no ordenarse. Este orden es una sugerencia que se puede usar para priorizar cómo se capturan los datos de la red, pero la interfaz de usuario siempre puede aplicar un orden específico.
Devoluciones
- Atributos
Excepciones
Comentarios
Devuelve los documentos secundarios incluidos en el directorio solicitado. Esto solo debe devolver descendientes inmediatos, ya que se emitirán consultas adicionales para explorar de forma recursiva el árbol.
Las aplicaciones que tienen como destino android.os.Build.VERSION_CODES#O o superior deben invalidar #queryChildDocuments(String, String[], Bundle).
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 devolver un cursor con extras, debe extender e invalidar Cursor#getExtras().
Para admitir las notificaciones de cambio, debe Cursor#setNotificationUri(ContentResolver, Uri) tener un URI pertinente, como DocumentsContract#buildChildDocumentsUri(String, String). A continuación, puede llamar ContentResolver#notifyChange(Uri, android.database.ContentObserver, boolean) a con ese URI para enviar notificaciones de cambio.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.