ContentResolver.Query Método

Definição

Namespace:

Android.Content

Assembly:

Mono.Android.dll

Sobrecargas

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

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

Consulte o URI fornecido, retornando um sobre o conjunto de Cursor 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 o conteúdo a ser recuperado.

projection

String[]

Uma lista de quais colunas retornar. Passar null retornará todas as colunas, o que é ineficiente.

queryArgs

Bundle

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

cancellationSignal

CancellationSignal

Um sinal para cancelar a operação em andamento, ou null se nenhum. Se a operação for cancelada, será OperationCanceledException lançada 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 sobre o conjunto de Cursor 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 honrados durante a preparação do conjunto de resultados, incluindo as respectivas chaves de argumento nos Cursor extras Bundle. Confira #EXTRA_HONORED_ARGS para obter detalhes.

Documentação Java 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 Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

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

Consulte o URI fornecido, retornando um sobre o conjunto de Cursor 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 o conteúdo a ser recuperado.

projection

String[]

Uma lista de quais colunas retornar. Passar null retornará todas as colunas, o que é ineficiente.

selection

String

Um filtro declarando quais linhas retornar, formatado como uma cláusula SQL WHERE (excluindo o próprio WHERE). Passar null 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 aparecem na seleção. Os valores serão vinculados como Strings.

sortOrder

String

Como ordenar as linhas, formatadas como uma cláusula SQL ORDER BY (excluindo a ORDER BY itself). Passar null usará a ordem de classificação padrão, que pode ser desordenada.

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 sobre o conjunto de Cursor resultados.

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

Documentação Java 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 Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Confira também

• ICursor

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

Consulte o URI fornecido, retornando um sobre o conjunto de Cursor 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 o conteúdo a ser recuperado.

projection

String[]

Uma lista de quais colunas retornar. Passar null retornará todas as colunas, o que é ineficiente.

selection

String

Um filtro declarando quais linhas retornar, formatado como uma cláusula SQL WHERE (excluindo o próprio WHERE). Passar null 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 aparecem na seleção. Os valores serão vinculados como Strings.

sortOrder

String

Como ordenar as linhas, formatadas como uma cláusula SQL ORDER BY (excluindo a ORDER BY itself). Passar null usará a ordem de classificação padrão, que pode ser desordenada.

cancellationSignal

CancellationSignal

Um sinal para cancelar a operação em andamento, ou null se nenhum. Se a operação for cancelada, será OperationCanceledException lançada 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 sobre o conjunto de Cursor resultados com suporte opcional para cancelamento.

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

Documentação Java 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 Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Confira também

• ICursor