MoveFirst, MoveLast, MoveNext, dan MovePrevious Methods (ADO)

  • Artikel

Berpindah ke rekaman pertama, terakhir, berikutnya, atau sebelumnya dalam objek Recordset tertentu dan membuat rekaman tersebut menjadi rekaman saat ini.

Sintaks

  
recordset.{MoveFirst | MoveLast | MoveNext | MovePrevious}

Keterangan

Gunakan metode MoveFirst untuk memindahkan posisi rekaman saat ini ke rekaman pertama di Recordset.

Gunakan metode MoveLast untuk memindahkan posisi rekaman saat ini ke rekaman terakhir di Recordset. Objek Recordset harus mendukung marka buku atau gerakan kursor mundur; jika tidak, panggilan metode akan menghasilkan kesalahan.

Panggilan ke MoveFirst atau MoveLast saat Recordset kosong ( BOF dan EOF benar) menghasilkan kesalahan.

Gunakan metode MoveNext untuk memindahkan posisi rekaman saat ini satu rekaman ke depan (ke bagian bawah Recordset). Jika rekaman terakhir adalah rekaman saat ini dan Anda memanggil metode MoveNext , ADO mengatur rekaman saat ini ke posisi setelah rekaman terakhir di Recordset (EOF adalah True). Upaya untuk bergerak maju ketika properti EOF sudah True menghasilkan kesalahan.

Di ADO 2.5 dan yang lebih baru, ketika Recordset telah difilter atau diurutkan dan data rekaman saat ini diubah, memanggil metode MoveNext memindahkan kursor dua rekaman ke depan dari rekaman saat ini. Ini karena ketika rekaman saat ini diubah, rekaman berikutnya menjadi rekaman baru saat ini. Memanggil MoveNext setelah perubahan memindahkan kursor satu rekaman ke depan dari rekaman baru saat ini. Ini berbeda dari perilaku di ADO 2.1 dan yang lebih lama. Dalam versi sebelumnya ini, mengubah data rekaman saat ini di Recordset yang diurutkan atau difilter tidak mengubah posisi rekaman saat ini, dan MoveNext memindahkan kursor ke rekaman berikutnya segera setelah rekaman saat ini.

Gunakan metode MovePrevious untuk memindahkan posisi rekaman saat ini satu rekaman mundur (ke bagian atas Recordset). Objek Recordset harus mendukung marka buku atau gerakan kursor mundur; jika tidak, panggilan metode akan menghasilkan kesalahan. Jika rekaman pertama adalah rekaman saat ini dan Anda memanggil metode MovePrevious , ADO mengatur rekaman saat ini ke posisi sebelum rekaman pertama di Recordset (BOF adalah True). Upaya untuk bergerak mundur ketika properti BOF sudah True menghasilkan kesalahan. Jika objek Recordset tidak mendukung bookmark atau gerakan kursor mundur, metode MovePrevious akan menghasilkan kesalahan.

Jika Recordset hanya diteruskan dan Anda ingin mendukung pengguliran maju dan mundur, Anda dapat menggunakan properti CacheSize untuk membuat cache rekaman yang akan mendukung gerakan kursor mundur melalui metode Pindahkan . Karena rekaman yang di-cache dimuat ke dalam memori, Anda harus menghindari penembolokan lebih banyak rekaman daripada yang diperlukan. Anda dapat memanggil metode MoveFirst dalam objek Recordset hanya-teruskan; melakukannya dapat menyebabkan penyedia menjalankan kembali perintah yang menghasilkan objek Recordset .

Berlaku Untuk

Objek Recordset (ADO)

Lihat juga

MoveFirst, MoveLast, MoveNext, dan MovePrevious Methods Example (VB)
MoveFirst, MoveLast, MoveNext, dan MovePrevious Methods Example (VBScript)
MoveFirst, MoveLast, MoveNext, dan MovePrevious Methods Example (VC++)
Metode Pemindahan (ADO)
Metode MoveFirst, MoveLast, MoveNext, dan MovePrevious (RDS)
Metode MoveRecord (ADO)