ContentResolver.Query Metode

Definisi

Ruang nama:: Android.Content

Rakitan:: Mono.Android.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Overload

Nama	Deskripsi
Query(Uri, String[], Bundle, CancellationSignal)	Kueri URI yang diberikan, mengembalikan hasil yang `Cursor` ditetapkan dengan dukungan untuk pembatalan.
Query(Uri, String[], String, String[], String)	Kueri URI yang `Cursor` diberikan, mengembalikan lebih dari tataan hasil.
Query(Uri, String[], String, String[], String, CancellationSignal)	Kueri URI yang diberikan, mengembalikan hasil yang `Cursor` ditetapkan dengan dukungan opsional untuk pembatalan.

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

Kueri URI yang diberikan, mengembalikan hasil yang Cursor ditetapkan dengan dukungan untuk pembatalan.

[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

Parameter

uri: Uri

URI, menggunakan skema content://, agar konten diambil.

projection: String[]

Daftar kolom mana yang akan dikembalikan. Meneruskan null akan mengembalikan semua kolom, yang tidak efisien.

queryArgs: Bundle

Bundel yang berisi informasi tambahan yang diperlukan untuk operasi. Argumen dapat mencakup argumen gaya SQL, seperti ContentResolver#QUERY_ARG_SQL_LIMIT, tetapi perhatikan bahwa dokumentasi untuk setiap penyedia individu akan menunjukkan argumen mana yang mereka dukung.

cancellationSignal: CancellationSignal

Sinyal untuk membatalkan operasi yang sedang berlangsung, atau null jika tidak ada. Jika operasi dibatalkan, maka OperationCanceledException akan dilemparkan saat kueri dijalankan.

Mengembalikan

ICursor

Objek Kursor, yang diposisikan sebelum entri pertama. Dapat kembali null jika penyedia konten yang mendasar nullmengembalikan , atau jika crash.

Atribut: RegisterAttribute

Keterangan

Kueri URI yang diberikan, mengembalikan hasil yang Cursor ditetapkan dengan dukungan untuk pembatalan.

Untuk performa terbaik, pemanggil harus mengikuti panduan berikut:

<li>Berikan proyeksi eksplisit, untuk mencegah membaca data dari penyimpanan yang tidak akan digunakan.

Penyedia harus mengidentifikasi argumen QUERY_ARG_SORT* mana yang dihormati selama persiapan hasil yang ditetapkan dengan menyertakan kunci argumen masing-masing dalam Cursor ekstra Bundle. Lihat #EXTRA_HONORED_ARGS untuk detailnya.

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

Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.

Berlaku untuk

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

Kueri URI yang Cursor diberikan, mengembalikan lebih dari tataan hasil.

[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

Parameter

uri: Uri

URI, menggunakan skema content://, agar konten diambil.

projection: String[]

Daftar kolom mana yang akan dikembalikan. Meneruskan null akan mengembalikan semua kolom, yang tidak efisien.

selection: String

Filter yang mendeklarasikan baris mana yang akan dikembalikan, diformat sebagai klausa SQL WHERE (tidak termasuk WHERE itu sendiri). Meneruskan null akan mengembalikan semua baris untuk URI yang diberikan.

selectionArgs: String[]

Anda dapat menyertakan ?s dalam pilihan, yang akan digantikan oleh nilai dari selectionArgs, dalam urutan muncul dalam pilihan. Nilai akan terikat sebagai String.

sortOrder: String

Cara mengurutkan baris, diformat sebagai klausul SQL ORDER BY (tidak termasuk ORDER BY itu sendiri). Meneruskan null akan menggunakan urutan pengurutan default, yang mungkin tidak diurutkan.

Mengembalikan

ICursor

Objek Kursor, yang diposisikan sebelum entri pertama. Dapat kembali null jika penyedia konten yang mendasar nullmengembalikan , atau jika crash.

Atribut: RegisterAttribute

Keterangan

Kueri URI yang Cursor diberikan, mengembalikan lebih dari tataan hasil.

Untuk performa terbaik, pemanggil harus mengikuti panduan ini: <ul><li>Berikan proyeksi eksplisit, untuk mencegah membaca data dari penyimpanan yang tidak akan digunakan.</li li><>Gunakan penanda parameter tanda tanya seperti 'phone=?' alih-alih nilai eksplisit dalam selection parameter, sehingga kueri yang hanya berbeda dengan nilai tersebut akan dikenali sama untuk tujuan penembolokan.</li></ul>

Java dokumentasi untuk android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String).

Lihat juga

ICursor

Berlaku untuk

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

Kueri URI yang diberikan, mengembalikan hasil yang Cursor ditetapkan dengan dukungan opsional untuk pembatalan.

[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

Parameter

uri: Uri

URI, menggunakan skema content://, agar konten diambil.

projection: String[]

Daftar kolom mana yang akan dikembalikan. Meneruskan null akan mengembalikan semua kolom, yang tidak efisien.

selection: String

selectionArgs: String[]

Anda dapat menyertakan ?s dalam pilihan, yang akan digantikan oleh nilai dari selectionArgs, dalam urutan muncul dalam pilihan. Nilai akan terikat sebagai String.

sortOrder: String

Cara mengurutkan baris, diformat sebagai klausul SQL ORDER BY (tidak termasuk ORDER BY itu sendiri). Meneruskan null akan menggunakan urutan pengurutan default, yang mungkin tidak diurutkan.

cancellationSignal: CancellationSignal

Sinyal untuk membatalkan operasi yang sedang berlangsung, atau null jika tidak ada. Jika operasi dibatalkan, maka OperationCanceledException akan dilemparkan saat kueri dijalankan.

Mengembalikan

ICursor

Objek Kursor, yang diposisikan sebelum entri pertama. Dapat kembali null jika penyedia konten yang mendasar nullmengembalikan , atau jika crash.

Atribut: RegisterAttribute

Keterangan

Kueri URI yang diberikan, mengembalikan hasil yang Cursor ditetapkan dengan dukungan opsional untuk pembatalan.

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

Lihat juga

ICursor

Berlaku untuk