Menggulir dan Mengambil Baris (ODBC)

Saat menggunakan kursor yang dapat digulir, aplikasi memanggil SQLFetchScroll untuk memosisikan kursor dan mengambil baris. SQLFetchScroll mendukung pengguliran relatif (berikutnya, sebelumnya, dan relatif n baris), pengguliran absolut (pertama, terakhir, dan baris n), dan penempatan berdasarkan marka buku. Argumen FetchOrientation dan FetchOffset di SQLFetchScroll menentukan kumpulan baris mana yang akan diambil, seperti yang ditunjukkan dalam diagram berikut.

Mengambil Set Baris Berikutnya, Sebelumnya, Pertama, dan Terakhir

Mengambil Set Baris Absolut, Relatif, dan Marka Buku

SQLFetchScroll memposisikan kursor ke baris yang ditentukan dan mengembalikan baris dalam set baris yang dimulai dengan baris tersebut. Jika set baris yang ditentukan tumpang tindih dengan akhir kumpulan hasil, set baris parsial akan dikembalikan. Jika set baris yang ditentukan tumpang tindih dengan awal kumpulan hasil, set baris pertama dalam kumpulan hasil biasanya dikembalikan; untuk detail lengkapnya, lihat deskripsi fungsi SQLFetchScroll .

Dalam beberapa kasus, aplikasi mungkin ingin memosisikan kursor tanpa mengambil data apa pun. Misalnya, mungkin ingin menguji apakah ada baris atau hanya mendapatkan marka buku untuk baris tanpa membawa data lain di seluruh jaringan. Untuk melakukan ini, ia mengatur atribut pernyataan SQL_ATTR_RETRIEVE_DATA ke SQL_RD_OFF. Variabel yang terikat ke kolom marka buku (jika ada) selalu diperbarui, terlepas dari pengaturan atribut pernyataan ini.

Setelah himpunan baris diambil, aplikasi dapat memanggil SQLSetPos untuk memosisikan ke baris tertentu di set baris atau me-refresh baris di set baris. Untuk informasi selengkapnya tentang menggunakan SQLSetPos, lihat Memperbarui Data dengan SQLSetPos.

Catatan

Pengguliran didukung di ODBC 2.driver x oleh SQLExtendedFetch. Untuk informasi selengkapnya, lihat Memblokir Kursor, Kursor yang Dapat Digulir, dan Kompatibilitas Mundur dalam Lampiran G: Panduan Driver untuk Kompatibilitas Mundur.