Properti BOF, EOF (ADO)

  • BOF Menunjukkan bahwa posisi rekaman saat ini adalah sebelum rekaman pertama dalam objek Recordset .

  • EOF Menunjukkan bahwa posisi rekaman saat ini adalah setelah rekaman terakhir dalam objek Recordset .

Tampilkan Nilai

Properti BOF dan EOF mengembalikan nilai Boolean .

Keterangan

Gunakan properti BOF dan EOF untuk menentukan apakah objek Recordset berisi rekaman atau apakah Anda telah melampaui batas objek Recordset saat Anda berpindah dari rekaman ke rekaman.

Properti BOF mengembalikan True (-1) jika posisi rekaman saat ini adalah sebelum rekaman pertama dan False (0) jika posisi rekaman saat ini aktif atau setelah rekaman pertama.

Properti EOF mengembalikan True jika posisi rekaman saat ini adalah setelah rekaman terakhir dan False jika posisi rekaman saat ini aktif atau sebelum rekaman terakhir.

Jika properti BOF atau EOFtrue, tidak ada rekaman saat ini.

Jika Anda membuka objek Recordset yang tidak berisi rekaman, properti BOF dan EOF diatur ke True (lihat properti RecordCount untuk informasi selengkapnya tentang status Recordset ini). Saat Anda membuka objek Recordset yang berisi setidaknya satu rekaman, rekaman pertama adalah rekaman saat ini dan properti BOF dan EOF adalah False.

Jika Anda menghapus rekaman terakhir yang tersisa di objek Recordset , properti BOF dan EOF mungkin tetap False hingga Anda mencoba memposisikan ulang rekaman saat ini.

Tabel ini menunjukkan metode Move mana yang diizinkan dengan kombinasi properti BOF dan EOF yang berbeda.

MoveFirst,

MoveLast
MovePrevious,

Pindahkan < 0
Pindahkan 0 MoveNext,

Pindahkan > 0
BOF=Benar, EOF=False Diizinkan Kesalahan Kesalahan Diizinkan
BOF=False, EOF=True Diizinkan Diizinkan Kesalahan Kesalahan
Keduanya Benar Kesalahan Kesalahan Kesalahan Kesalahan
Keduanya False Diizinkan Diizinkan Diizinkan Diizinkan

Mengizinkan metode Move tidak menjamin bahwa metode akan berhasil menemukan rekaman; itu hanya berarti bahwa memanggil metode Pindah yang ditentukan tidak akan menghasilkan kesalahan.

Tabel berikut ini memperlihatkan apa yang terjadi pada pengaturan properti BOF dan EOF saat Anda memanggil berbagai metode Pindahkan tetapi tidak berhasil menemukan rekaman.

BOF Eof
MoveFirst, MoveLast Atur ke True Atur ke True
Pindahkan 0 Tidak Ada Perubahan Tidak Ada Perubahan
MovePrevious, Move< 0 Atur ke True Tidak Ada Perubahan
MoveNext, Move> 0 Tidak Ada Perubahan Atur ke True

Berlaku Untuk

Objek Recordset (ADO)

Lihat juga

Contoh Properti BOF, EOF, dan Bookmark (Visual Basic)
Contoh Properti BOF, EOF, dan Bookmark (VC++)