Temukan Metode (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 mulai) Recordset.

Sintaksis

  
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
Fakultatif. Nilai Panjang, yang nilai defaultnya adalah nol, yang menentukan offset baris dari baris saat ini atau Mulai bookmark untuk memulai pencarian. Secara default, pencarian akan dimulai pada baris saat ini.

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

Mulai
Fakultatif. Bookmark Varian yang berfungsi sebagai posisi awal untuk pencarian.

Komentar

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 terkemuka dan berikutnya untuk menemukan substring yang terkandung dalam nilai. Misalnya, "state like '*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 wildcard terkemuka ('*str'), atau sebagai kartubebas tertanam ('s*r'). Ini akan menyebabkan kesalahan.

Nota

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.

Nota

Jika Anda memanggil metode Find 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 kumpulan rekaman.

Berlaku Untuk

Recordset Object (ADO)

Lihat Juga

Temukan Contoh Metode (VB)
Properti Indeks
Mengoptimalkan Property-Dynamic (ADO)
Metode Pencarian