Linguaggio

ContentResolver.Query Metodo

Definizione

Overload

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

Eseguire una query sull'URI specificato, restituendo un Cursor oggetto sul set di risultati con supporto per l'annullamento.

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

Eseguire una query sull'URI specificato, restituendo un Cursor oggetto sul set di risultati.

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

Eseguire una query sull'URI specificato, restituendo un Cursor oggetto sul set di risultati con supporto facoltativo per l'annullamento.

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

Eseguire una query sull'URI specificato, restituendo un Cursor oggetto sul set di risultati con supporto per l'annullamento.

[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

Parametri

uri
Uri

L'URI, utilizzando lo schema content://, per il contenuto da recuperare.

projection
String[]

Elenco delle colonne da restituire. Il passaggio di null restituirà tutte le colonne, che non sono efficienti.

queryArgs
Bundle

Bundle contenente informazioni aggiuntive necessarie per l'operazione. Gli argomenti possono includere argomenti di stile SQL, ad esempio ContentResolver#QUERY_ARG_SQL_LIMIT, ma si noti che la documentazione per ogni singolo provider indicherà gli argomenti supportati.

cancellationSignal
CancellationSignal

Segnale per annullare l'operazione in corso o null se nessuno. Se l'operazione viene annullata, OperationCanceledException verrà generata quando viene eseguita la query.

Valori restituiti

Oggetto Cursor, posizionato prima della prima voce. Può restituire null se il provider di contenuti sottostante restituisce nullo se si arresta in modo anomalo.

Attributi

Commenti

Eseguire una query sull'URI specificato, restituendo un Cursor oggetto sul set di risultati con supporto per l'annullamento.

Per ottenere prestazioni ottimali, il chiamante deve seguire queste linee guida:

<li>Fornire una proiezione esplicita, per impedire la lettura dei dati dall'archiviazione che non verranno usati.

Il provider deve identificare quali argomenti QUERY_ARG_SORT* sono stati rispettati durante la preparazione del set di risultati includendo le rispettive chiavi di argomento negli Cursor elementi aggiuntivi Bundle. Per informazioni dettagliate, vedere #EXTRA_HONORED_ARGS.

per android.content.ContentResolver.query(android.net.Uri, java.lang.String[], android.os.Bundle, android.os.CancellationSignal).

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

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

Eseguire una query sull'URI specificato, restituendo un Cursor oggetto sul set di risultati.

[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

Parametri

uri
Uri

L'URI, utilizzando lo schema content://, per il contenuto da recuperare.

projection
String[]

Elenco delle colonne da restituire. Il passaggio di null restituirà tutte le colonne, che non sono efficienti.

selection
String

Filtro che dichiara le righe da restituire, formattate come clausola SQL WHERE (escluso il WHERE stesso). Il passaggio di null restituirà tutte le righe per l'URI specificato.

selectionArgs
String[]

È possibile includere ?s nella selezione, che verrà sostituito dai valori di selectionArgs, nell'ordine in cui vengono visualizzati nella selezione. I valori verranno associati come stringhe.

sortOrder
String

Come ordinare le righe, formattate come clausola SQL ORDER BY (escluso order BY). Il passaggio di Null userà l'ordinamento predefinito, che può essere non ordinato.

Valori restituiti

Oggetto Cursor, posizionato prima della prima voce. Può restituire null se il provider di contenuti sottostante restituisce nullo se si arresta in modo anomalo.

Attributi

Commenti

Eseguire una query sull'URI specificato, restituendo un Cursor oggetto sul set di risultati.

Per ottenere prestazioni ottimali, il chiamante deve seguire queste linee guida: <ul><li>Fornire una proiezione esplicita, per impedire la lettura dei dati dall'archiviazione che non verranno usati.</li><li>Usare indicatori di parametro del punto interrogativo, ad esempio 'phone=?' anziché valori espliciti nel selection parametro, in modo che le query che differiscono solo per tali valori vengano riconosciute come uguali a scopo di memorizzazione nella cache.</li></ul>

per android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String).

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.

Vedi anche

Si applica a

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

Eseguire una query sull'URI specificato, restituendo un Cursor oggetto sul set di risultati con supporto facoltativo per l'annullamento.

[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

Parametri

uri
Uri

L'URI, utilizzando lo schema content://, per il contenuto da recuperare.

projection
String[]

Elenco delle colonne da restituire. Il passaggio di null restituirà tutte le colonne, che non sono efficienti.

selection
String

Filtro che dichiara le righe da restituire, formattate come clausola SQL WHERE (escluso il WHERE stesso). Il passaggio di null restituirà tutte le righe per l'URI specificato.

selectionArgs
String[]

È possibile includere ?s nella selezione, che verrà sostituito dai valori di selectionArgs, nell'ordine in cui vengono visualizzati nella selezione. I valori verranno associati come stringhe.

sortOrder
String

Come ordinare le righe, formattate come clausola SQL ORDER BY (escluso order BY). Il passaggio di Null userà l'ordinamento predefinito, che può essere non ordinato.

cancellationSignal
CancellationSignal

Segnale per annullare l'operazione in corso o null se nessuno. Se l'operazione viene annullata, OperationCanceledException verrà generata quando viene eseguita la query.

Valori restituiti

Oggetto Cursor, posizionato prima della prima voce. Può restituire null se il provider di contenuti sottostante restituisce nullo se si arresta in modo anomalo.

Attributi

Commenti

Eseguire una query sull'URI specificato, restituendo un Cursor oggetto sul set di risultati con supporto facoltativo per l'annullamento.

Per ottenere prestazioni ottimali, il chiamante deve seguire queste linee guida: <ul><li>Fornire una proiezione esplicita, per impedire la lettura dei dati dall'archiviazione che non verranno usati.</li><li>Usare indicatori di parametro del punto interrogativo, ad esempio 'phone=?' anziché valori espliciti nel selection parametro, in modo che le query che differiscono solo per tali valori vengano riconosciute come uguali a scopo di memorizzazione nella cache.</li></ul>

per android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String, android.os.CancellationSignal).

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.

Vedi anche

Si applica a