ContentResolver.Query Método

Definição

Namespace:: Android.Content

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

Nome	Description
Query(Uri, String[], Bundle, CancellationSignal)	Consulte o URI fornecido, retornando um `Cursor` sobre o conjunto de resultados com suporte para cancelamento.
Query(Uri, String[], String, String[], String)	Consulte o URI fornecido, retornando um `Cursor` sobre o conjunto de resultados.
Query(Uri, String[], String, String[], String, CancellationSignal)	Consulte o URI fornecido, retornando um `Cursor` sobre o conjunto de resultados com suporte opcional para cancelamento.

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

Consulte o URI fornecido, retornando um Cursor sobre o conjunto de resultados com suporte para cancelamento.

[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

O URI, usando o esquema content://, para que o conteúdo seja recuperado.

projection: String[]

Uma lista de quais colunas devem ser retornadas. Passar nulo retornará todas as colunas, o que é ineficiente.

queryArgs: Bundle

Um pacote que contém informações adicionais necessárias para a operação. Os argumentos podem incluir argumentos de estilo SQL, como ContentResolver#QUERY_ARG_SQL_LIMIT, por exemplo, mas observe que a documentação de cada provedor individual indicará quais argumentos eles dão suporte.

cancellationSignal: CancellationSignal

Um sinal para cancelar a operação em andamento ou nulo se nenhum. Se a operação for cancelada, será OperationCanceledException gerada quando a consulta for executada.

Retornos

ICursor

Um objeto Cursor, que é posicionado antes da primeira entrada. Pode retornar null se o provedor de conteúdo subjacente retornar nullou se ele falhar.

Atributos: RegisterAttribute

Comentários

Consulte o URI fornecido, retornando um Cursor sobre o conjunto de resultados com suporte para cancelamento.

Para obter o melhor desempenho, o chamador deve seguir estas diretrizes:

<li>Forneça uma projeção explícita, para impedir a leitura de dados do armazenamento que não serão usados.

O provedor deve identificar quais argumentos QUERY_ARG_SORT* foram respeitados durante a preparação do conjunto de resultados, incluindo as respectivas chaves de argumento nos Cursor extras Bundle. Consulte #EXTRA_HONORED_ARGS para obter detalhes.

Java documentação para android.content.ContentResolver.query(android.net.Uri, java.lang.String[], android.os.Bundle, android.os.CancellationSignal).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a

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

Consulte o URI fornecido, retornando um Cursor sobre o 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

O URI, usando o esquema content://, para que o conteúdo seja recuperado.

projection: String[]

Uma lista de quais colunas devem ser retornadas. Passar nulo retornará todas as colunas, o que é ineficiente.

selection: String

Um filtro que declara quais linhas retornar, formatadas como uma cláusula SQL WHERE (excluindo o próprio WHERE). Passar nulo retornará todas as linhas para o URI fornecido.

selectionArgs: String[]

Você pode incluir ?s na seleção, que será substituída pelos valores de selectionArgs, na ordem em que eles aparecerem na seleção. Os valores serão associados como Cadeias de Caracteres.

sortOrder: String

Como ordenar as linhas, formatadas como uma cláusula SQL ORDER BY (excluindo a ORDEM POR si só). Passar nulo usará a ordem de classificação padrão, que pode não ser ordenada.

Retornos

ICursor

Um objeto Cursor, que é posicionado antes da primeira entrada. Pode retornar null se o provedor de conteúdo subjacente retornar nullou se ele falhar.

Atributos: RegisterAttribute

Comentários

Consulte o URI fornecido, retornando um Cursor sobre o conjunto de resultados.

Para obter melhor desempenho, o chamador deve seguir estas diretrizes: <ul><li>Fornecer uma projeção explícita, para impedir a leitura de dados do armazenamento que não serão usados.</li li><>Usar marcadores de parâmetro de ponto de interrogação, como 'phone=?' em vez de valores explícitos no selection parâmetro, para que as consultas que diferem apenas por esses valores sejam reconhecidas como iguais para fins de cache.</li></ul>

Java documentação para android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Confira também

ICursor

Aplica-se a

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

Consulte o URI fornecido, retornando um Cursor sobre o conjunto de resultados com suporte opcional para cancelamento.

[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

O URI, usando o esquema content://, para que o conteúdo seja recuperado.

projection: String[]

Uma lista de quais colunas devem ser retornadas. Passar nulo retornará todas as colunas, o que é ineficiente.

selection: String

Um filtro que declara quais linhas retornar, formatadas como uma cláusula SQL WHERE (excluindo o próprio WHERE). Passar nulo retornará todas as linhas para o URI fornecido.

selectionArgs: String[]

Você pode incluir ?s na seleção, que será substituída pelos valores de selectionArgs, na ordem em que eles aparecerem na seleção. Os valores serão associados como Cadeias de Caracteres.

sortOrder: String

Como ordenar as linhas, formatadas como uma cláusula SQL ORDER BY (excluindo a ORDEM POR si só). Passar nulo usará a ordem de classificação padrão, que pode não ser ordenada.

cancellationSignal: CancellationSignal

Um sinal para cancelar a operação em andamento ou nulo se nenhum. Se a operação for cancelada, será OperationCanceledException gerada quando a consulta for executada.

Retornos

ICursor

Um objeto Cursor, que é posicionado antes da primeira entrada. Pode retornar null se o provedor de conteúdo subjacente retornar nullou se ele falhar.

Atributos: RegisterAttribute

Comentários

Consulte o URI fornecido, retornando um Cursor sobre o conjunto de resultados com suporte opcional para cancelamento.

Java documentação para android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String, android.os.CancellationSignal).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Confira também

ICursor

Aplica-se a