Properti AbsolutePosition (ADO)

Menunjukkan posisi ordinal rekaman objek Recordset saat ini.

Pengaturan dan Nilai Yang Dikembalikan

Untuk kode 32-bit, mengatur atau mengembalikan nilai Panjang dari 1 ke jumlah rekaman dalam objek Recordset (RecordCount), atau mengembalikan salah satu nilai PositionEnum .

Untuk kode 64-bit, gunakan jenis data yang menyediakan penyimpanan nilai 64-bit. Misalnya, Anda dapat menggunakan Panjang atau nilai lain dengan panjang 64-bit seperti DBORDINAL. Jangan gunakan nilai PositionEnum karena dibatasi hingga panjang 32-bit.

Keterangan

Untuk mengatur properti AbsolutePosition , ADO mengharuskan penyedia OLE DB yang Anda gunakan menerapkan antarmuka IRowsetLocate:IRowset .

Mengakses properti AbsolutePosition dari Recordset yang dibuka dengan kursor maju-saja atau dinamis menimbulkan kesalahan adErrFeatureNotAvailable. Dengan jenis kursor lainnya, posisi yang benar akan dikembalikan selama penyedia OLE DB mendukung antarmuka IRowsetScroll:IRowsetLocate . Jika penyedia tidak mendukung antarmuka IRowsetScroll , properti diatur ke adPosUnknown. Lihat dokumentasi untuk penyedia Anda untuk menentukan apakah mendukung IRowsetScroll.

Gunakan properti AbsolutePosition untuk berpindah ke rekaman berdasarkan posisi ordinalnya di objek Recordset , atau untuk menentukan posisi ordinal rekaman saat ini. Penyedia harus mendukung fungsionalitas yang sesuai agar properti ini tersedia.

Seperti properti AbsolutePage , AbsolutePosition berbasis 1 dan sama dengan 1 ketika rekaman saat ini adalah rekaman pertama dalam Recordset. Anda bisa mendapatkan jumlah total rekaman di objek Recordset dari properti RecordCount .

Saat Anda mengatur properti AbsolutePosition , meskipun ke rekaman di cache saat ini, ADO memuat ulang cache dengan grup rekaman baru yang dimulai dengan catatan yang Anda tentukan. Properti CacheSize menentukan ukuran grup ini.

Catatan

Anda tidak boleh menggunakan properti AbsolutePosition sebagai nomor rekaman pengganti. Posisi rekaman tertentu berubah saat Anda menghapus rekaman sebelumnya. Juga tidak ada jaminan bahwa rekaman tertentu akan memiliki AbsolutePosition yang sama jika objek Recordset dikueri ulang atau dibuka kembali. Marka buku masih merupakan cara yang direkomendasikan untuk mempertahankan dan kembali ke posisi tertentu dan merupakan satu-satunya cara untuk memposisikan di semua jenis objek Recordset .

Berlaku Untuk

Objek Recordset (ADO)

Lihat juga

Contoh Properti AbsolutePosition dan CursorLocation (VB)
Contoh Properti AbsolutePosition dan CursorLocation (VC++)
Properti AbsolutePage (ADO)
Properti RecordCount (ADO)