Metode Pemindahan (ADO)

Memindahkan posisi rekaman saat ini dalam objek Recordset.

Sintaksis

  
recordset.Move NumRecords, Start  

Parameter-parameternya

NumRecords
Ekspresi Panjang bertanda tangan yang menentukan jumlah rekaman yang dipindahkan posisi rekaman saat ini.

Mulai
Fakultatif. Nilai String atau Varian yang mengevaluasi ke marka buku. Anda juga dapat menggunakan nilai BookmarkEnum.

Komentar

Metode Pemindahan didukung pada semua objek Recordset.

Jika argumen NumRecords lebih besar dari nol, posisi catatan saat ini bergerak maju (mendekati akhir dari Recordset). Jika NumRecords kurang dari nol, posisi rekaman saat ini bergerak mundur (ke awal Recordset).

Jika panggilan Pindahkan akan memindahkan posisi rekaman saat ini ke titik sebelum rekaman pertama, ADO mengatur rekaman saat ini ke posisi sebelum rekaman pertama dalam kumpulan rekaman (BOF adalah True). Upaya untuk bergerak mundur ketika properti BOF sudah True menghasilkan kesalahan.

Jika panggilan Pindahkan akan memindahkan posisi rekaman saat ini ke titik setelah rekaman terakhir, ADO mengatur rekaman saat ini ke posisi setelah rekaman terakhir dalam kumpulan rekaman (EOF adalah True). Upaya untuk bergerak maju ketika properti EOF sudah True menghasilkan kesalahan.

Memanggil metode Move dari objek Recordset kosong menghasilkan kesalahan.

Jika Anda meneruskan argumen Mulai , pemindahan relatif terhadap rekaman dengan marka buku ini, dengan asumsi objek Recordset mendukung marka buku. Jika tidak ditentukan, perpindahan relatif terhadap rekaman saat ini.

Jika Anda menggunakan properti CacheSize ke rekaman cache lokal dari penyedia, meneruskan argumen NumRecords yang memindahkan posisi rekaman saat ini di luar grup rekaman cache saat ini memaksa ADO untuk mengambil grup rekaman baru, dimulai dari rekaman tujuan. Properti CacheSize menentukan ukuran grup yang baru diambil, dan rekaman tujuan adalah rekaman pertama yang diambil.

Jika objek Recordset hanya diteruskan, pengguna masih dapat meneruskan argumen NumRecords kurang dari nol, asalkan tujuan berada dalam kumpulan rekaman cache saat ini. Jika panggilan Pindahkan akan memindahkan posisi rekaman saat ini ke rekaman sebelum rekaman pertama yang di-cache, kesalahan akan terjadi. Dengan demikian, Anda dapat menggunakan cache rekaman yang mendukung pengguliran penuh melalui penyedia yang hanya mendukung pengguliran maju. Karena rekaman yang di-cache dimuat ke dalam memori, Anda harus menghindari penembolokan lebih banyak rekaman daripada yang diperlukan. Bahkan jika objek Recordset hanya maju mendukung gerakan mundur dengan cara ini, memanggil metode MovePrevious pada objek Recordset khusus maju masih akan menghasilkan kesalahan.

Nota

Dukungan untuk bergerak mundur dalam Recordset forward-only tidak dapat diprediksi, tergantung pada penyedia Anda. Jika rekaman saat ini telah diposisikan setelah rekaman terakhir di Recordset, Pindahkan ke belakang mungkin tidak menghasilkan posisi saat ini yang benar.

Berlaku Pada

Objek Recordset (ADO)

Lihat Juga

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