Metode Pemindahan (ADO)

Memindahkan posisi rekaman saat ini dalam objek Recordset .

Sintaks

  
recordset.Move NumRecords, Start  

Parameter

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

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

Keterangan

Metode Pindahkan didukung pada semua objek Recordset .

Jika argumen NumRecords lebih besar dari nol, posisi rekaman saat ini bergerak maju (menuju akhir 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 recordset (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 recordset (EOF adalah True). Upaya untuk bergerak maju ketika properti EOF sudah True menghasilkan kesalahan.

Memanggil metode Pindahkan 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, pemindahan relatif terhadap rekaman saat ini.

Jika Anda menggunakan properti CacheSize untuk menyimpan rekaman cache secara 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, mulai 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 singgahan pertama, kesalahan akan terjadi. Dengan demikian, Anda dapat menggunakan cache rekaman yang mendukung pengguliran penuh di atas penyedia yang hanya mendukung pengguliran maju. Karena rekaman cache dimuat ke dalam memori, Anda harus menghindari penembolokan lebih banyak rekaman daripada yang diperlukan. Bahkan jika objek Recordset hanya maju mendukung perpindahan mundur dengan cara ini, memanggil metode MovePrevious pada objek Recordset hanya-maju akan tetap menghasilkan kesalahan.

Catatan

Dukungan untuk bergerak mundur dalam Recordset hanya maju tidak dapat diprediksi, tergantung pada penyedia Anda. Jika rekaman saat ini telah diposisikan setelah rekaman terakhir di Recordset, Pindah mundur mungkin tidak menghasilkan posisi saat ini yang benar.

Berlaku Untuk

Objek Recordset (ADO)

Lihat juga

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