Compartir a través de

ContentResolver.Query Método

  • Referencia

Definición

Espacio de nombres:
Android.Content
Ensamblado:
Mono.Android.dll

Sobrecargas

Query(Uri, String[], Bundle, CancellationSignal)

Consulte el URI especificado y devuelva un Cursor elemento sobre el conjunto de resultados con compatibilidad con la cancelación.
Query(Uri, String[], String, String[], String)

Consulte el URI especificado y devuelva un Cursor elemento sobre el conjunto de resultados.
Query(Uri, String[], String, String[], String, CancellationSignal)

Consulte el URI especificado y devuelva un Cursor elemento sobre el conjunto de resultados con compatibilidad opcional para la cancelación.

Query(Uri, String[], Bundle, CancellationSignal)

Consulte el URI especificado y devuelva un Cursor elemento sobre el conjunto de resultados con compatibilidad con la cancelación.

[Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Landroid/os/Bundle;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "", ApiSince=26)]
public Android.Database.ICursor? Query (Android.Net.Uri uri, string[]? projection, Android.OS.Bundle? queryArgs, Android.OS.CancellationSignal? cancellationSignal);
[<Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Landroid/os/Bundle;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "", ApiSince=26)>]
member this.Query : Android.Net.Uri * string[] * Android.OS.Bundle * Android.OS.CancellationSignal -> Android.Database.ICursor

Parámetros

uri
Uri

El URI, mediante el esquema content://, para que el contenido se recupere.

projection
String[]

Lista de las columnas que se van a devolver. Pasar null devolverá todas las columnas, lo que es ineficaz.

queryArgs
Bundle

Un paquete que contiene información adicional necesaria para la operación. Los argumentos pueden incluir argumentos de estilo SQL, como ContentResolver#QUERY_ARG_SQL_LIMIT, pero tenga en cuenta que la documentación de cada proveedor individual indicará qué argumentos admiten.

cancellationSignal
CancellationSignal

Señal para cancelar la operación en curso o null si no existe. Si se cancela la operación, OperationCanceledException se producirá cuando se ejecute la consulta.

Devoluciones

ICursor

Objeto Cursor, que se coloca antes de la primera entrada. Puede devolver null si el proveedor de contenido subyacente devuelve nullo si se bloquea.

Atributos
RegisterAttribute

Comentarios

Consulte el URI especificado y devuelva un Cursor elemento sobre el conjunto de resultados con compatibilidad con la cancelación.

Para obtener el mejor rendimiento, el autor de la llamada debe seguir estas instrucciones:

<li>Proporcione una proyección explícita para evitar que se lean datos del almacenamiento que no se van a usar.

El proveedor debe identificar qué argumentos QUERY_ARG_SORT* se respetaron durante la preparación del conjunto de resultados mediante la inclusión de las claves de argumento correspondientes en los Cursor extras Bundle. Para obtener información detallada, vea #EXTRA_HONORED_ARGS.

Documentación de Java para android.content.ContentResolver.query(android.net.Uri, java.lang.String[], android.os.Bundle, android.os.CancellationSignal).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a

Query(Uri, String[], String, String[], String)

Consulte el URI especificado y devuelva un Cursor elemento sobre el conjunto de resultados.

[Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;", "")]
public Android.Database.ICursor? Query (Android.Net.Uri uri, string[]? projection, string? selection, string[]? selectionArgs, string? sortOrder);
[<Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;", "")>]
member this.Query : Android.Net.Uri * string[] * string * string[] * string -> Android.Database.ICursor

Parámetros

uri
Uri

El URI, mediante el esquema content://, para que el contenido se recupere.

projection
String[]

Lista de las columnas que se van a devolver. Pasar null devolverá todas las columnas, lo que es ineficaz.

selection
String

Filtro que declara las filas que se van a devolver, con el formato de una cláusula WHERE de SQL (excepto el propio WHERE). Si se pasa null, se devolverán todas las filas del URI especificado.

selectionArgs
String[]

Puede incluir ?s en la selección, que se reemplazará por los valores de selectionArgs, en el orden en que aparecen en la selección. Los valores se enlazarán como Cadenas.

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.

Devoluciones

ICursor

Objeto Cursor, que se coloca antes de la primera entrada. Puede devolver null si el proveedor de contenido subyacente devuelve nullo si se bloquea.

Atributos
RegisterAttribute

Comentarios

Consulte el URI especificado y devuelva un Cursor elemento sobre el conjunto de resultados.

Para obtener el mejor rendimiento, el autor de la llamada debe seguir estas instrucciones: <ul<>li>Proporcione una proyección explícita para evitar que se lean datos del almacenamiento que no se van a usar.</li li><>Use marcadores de parámetros de signo de interrogación como 'phone=?' en lugar de valores explícitos en el selection parámetro , de modo que las consultas que solo difieren en esos valores se reconocerán como las mismas con fines de almacenamiento en caché.</li></ul>

Documentación de Java para android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Consulte también

Se aplica a

Query(Uri, String[], String, String[], String, CancellationSignal)

Consulte el URI especificado y devuelva un Cursor elemento sobre el conjunto de resultados con compatibilidad opcional para la cancelación.

[Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "")]
public Android.Database.ICursor? Query (Android.Net.Uri uri, string[]? projection, string? selection, string[]? selectionArgs, string? sortOrder, Android.OS.CancellationSignal? cancellationSignal);
[<Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "")>]
member this.Query : Android.Net.Uri * string[] * string * string[] * string * Android.OS.CancellationSignal -> Android.Database.ICursor

Parámetros

uri
Uri

El URI, mediante el esquema content://, para que el contenido se recupere.

projection
String[]

Lista de las columnas que se van a devolver. Pasar null devolverá todas las columnas, lo que es ineficaz.

selection
String

Filtro que declara las filas que se van a devolver, con el formato de una cláusula WHERE de SQL (excepto el propio WHERE). Si se pasa null, se devolverán todas las filas del URI especificado.

selectionArgs
String[]

Puede incluir ?s en la selección, que se reemplazará por los valores de selectionArgs, en el orden en que aparecen en la selección. Los valores se enlazarán como Cadenas.

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.

cancellationSignal
CancellationSignal

Señal para cancelar la operación en curso o null si no existe. Si se cancela la operación, OperationCanceledException se producirá cuando se ejecute la consulta.

Devoluciones

ICursor

Objeto Cursor, que se coloca antes de la primera entrada. Puede devolver null si el proveedor de contenido subyacente devuelve nullo si se bloquea.

Atributos
RegisterAttribute

Comentarios

Consulte el URI especificado y devuelva un Cursor elemento sobre el conjunto de resultados con compatibilidad opcional para la cancelación.

Para obtener el mejor rendimiento, el autor de la llamada debe seguir estas instrucciones: <ul<>li>Proporcione una proyección explícita para evitar que se lean datos del almacenamiento que no se van a usar.</li li><>Use marcadores de parámetros de signo de interrogación como 'phone=?' en lugar de valores explícitos en el selection parámetro , de modo que las consultas que solo difieren en esos valores se reconocerán como las mismas con fines de almacenamiento en caché.</li></ul>

Documentación de Java para android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String, android.os.CancellationSignal).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Consulte también

Se aplica a