ContentResolver.Query Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Query(Uri, String[], Bundle, CancellationSignal) |
Eseguire una query sull'URI specificato, restituendo un |
| Query(Uri, String[], String, String[], String) |
Eseguire una query sull'URI specificato, restituendo un |
| Query(Uri, String[], String, String[], String, CancellationSignal) |
Eseguire una query sull'URI specificato, restituendo un |
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.ICursorParametri
- 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.
Restituisce
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.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.
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.ICursorParametri
- 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.
Restituisce
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>
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.
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.ICursorParametri
- 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.
Restituisce
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>
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.