Metode Temukan (ADO)

Mencari Recordset untuk baris yang memenuhi kriteria yang ditentukan. Secara opsional, arah pencarian, baris awal, dan offset dari baris awal dapat ditentukan. Jika kriteria terpenuhi, posisi baris saat ini diatur pada rekaman yang ditemukan; jika tidak, posisi diatur ke akhir (atau awal) Dari Recordset.

Sintaks

  
Find (Criteria, SkipRows, SearchDirection, Start)  

Parameter

Kriteria
Nilai String yang berisi pernyataan yang menentukan nama kolom, operator perbandingan, dan nilai yang akan digunakan dalam pencarian.

SkipRows
Opsional. Nilai Panjang , yang nilai defaultnya adalah nol, yang menentukan offset baris dari baris saat ini atau Mulai marka buku untuk memulai pencarian. Secara default, pencarian akan dimulai pada baris saat ini.

SearchDirection
Opsional. Nilai SearchDirectionEnum yang menentukan apakah pencarian harus dimulai pada baris saat ini atau baris berikutnya yang tersedia dalam arah pencarian. Pencarian yang gagal berhenti di akhir Recordset jika nilainya adalah adSearchForward. Pencarian yang gagal berhenti di awal Recordset jika nilainya adalah adSearchBackward.

Mulai
Opsional. Marka buku Varian yang berfungsi sebagai posisi awal untuk pencarian.

Keterangan

Hanya nama kolom tunggal yang dapat ditentukan dalam kriteria. Metode ini tidak mendukung pencarian multi-kolom.

Operator perbandingan dalam Kriteria mungkin ">" (lebih besar dari), "<" (kurang dari), "=" (sama), ">=" (lebih besar dari atau sama), "<=" (kurang dari atau sama dengan), "<>" (tidak sama), atau "suka" (pencocokan pola).

Nilai dalam Kriteria mungkin berupa string, angka floating-point, atau tanggal. Nilai string dibatasi dengan tanda kutip tunggal atau tanda "#" (tanda angka) (misalnya, "state = 'WA'" atau "state = #WA#"). Nilai tanggal dibatasi dengan tanda "#" (tanda angka) (misalnya, "start_date > #7/22/97#"). Nilai-nilai ini dapat berisi jam, menit, dan detik untuk menunjukkan stempel waktu, tetapi tidak boleh berisi milidetik atau kesalahan akan terjadi.

Jika operator perbandingan adalah "like", nilai string mungkin berisi tanda bintang (*) untuk menemukan satu atau beberapa kemunculan karakter atau substring apa pun. Misalnya, "state like 'M*'" cocok dengan Maine dan Massachusetts. Anda juga dapat menggunakan tanda bintang di awal dan akhir untuk menemukan substring yang terkandung dalam nilai. Misalnya, "status seperti '*as*'" cocok dengan Alaska, Arkansas, dan Massachusetts.

Tanda bintang hanya dapat digunakan di akhir string kriteria, atau di awal dan akhir string kriteria, seperti yang ditunjukkan di atas. Anda tidak dapat menggunakan tanda bintang sebagai kartubebas utama ('*str'), atau sebagai kartubebas tertanam ('s*r'). Ini akan menyebabkan kesalahan.

Catatan

Kesalahan akan terjadi jika posisi baris saat ini tidak diatur sebelum memanggil Temukan. Metode apa pun yang mengatur posisi baris, seperti MoveFirst, harus dipanggil sebelum memanggil Temukan.

Catatan

Jika Anda memanggil metode Temukan pada recordset, dan posisi saat ini dalam recordset berada di rekaman terakhir atau akhir file (EOF), Anda tidak akan menemukan apa pun. Anda perlu memanggil metode MoveFirst untuk mengatur posisi/kursor saat ini ke awal recordset.

Berlaku Untuk

Objek Recordset (ADO)

Lihat juga

Temukan Contoh Metode (Visual Basic)
Properti Indeks
Optimalkan Property-Dynamic (ADO)
Metode Pencarian