Satırları Kaydırma ve Getirme (ODBC)

Kaydırılabilir bir imleç kullanırken, uygulamalar imleci konumlandırmak ve satırları getirmek için SQLFetchScroll'u çağırır. SQLFetchScroll göreli kaydırmayı (sonraki, önceki ve göreli n satır), mutlak kaydırmayı (ilk, son ve satır n) ve yer işaretine göre konumlandırmayı destekler. SQLFetchScroll'dakiFetchOrientation ve FetchOffset bağımsız değişkenleri, aşağıdaki diyagramlarda gösterildiği gibi hangi satır kümesinin getirileceğini belirtir.

Sonraki, Önceki, İlk ve Son Satır Kümesi Getir

Mutlak, Göreli ve Yer İşaretli Satır Kümeleri Getiriliyor

SQLFetchScroll imleci belirtilen satıra yerleştirir ve satır kümesindeki satırları bu satırdan başlayarak döndürür. Belirtilen satır kümesi sonuç kümesinin sonuyla çakışıyorsa, kısmi bir satır kümesi döndürülür. Belirtilen satır kümesi sonuç kümesinin başlangıcıyla çakışıyorsa, sonuç kümesindeki ilk satır kümesi genellikle döndürülür; Tüm ayrıntılar için bkz. SQLFetchScroll işlev açıklaması.

Bazı durumlarda, uygulama herhangi bir veri almadan imleci konumlandırmak isteyebilir. Örneğin, bir satırın var olup olmadığını test etmek veya diğer verileri ağ üzerinden getirmeden yalnızca satır için yer işaretini almak isteyebilir. Bunu yapmak için SQL_ATTR_RETRIEVE_DATA deyimi özniteliğini SQL_RD_OFF olarak ayarlar. Bu ifade niteliğinin ayarı ne olursa olsun, yer işareti sütununa bağlı değişken (varsa) her zaman güncellenir.

Satır kümesi alındıktan sonra uygulama, satır kümesindeki belirli bir satıra konumlandırmak veya satır kümesindeki satırları yenilemek için SQLSetPos'u çağırabilir. SQLSetPos kullanma hakkında daha fazla bilgi için bkz. SQLSetPos ile Verileri Güncelleştirme.

Uyarı

ODBC 2.x sürücülerinde kaydırma, SQLExtendedFetch tarafından desteklenir. Daha fazla bilgi için bkz. Ek G: Geriye Dönük Uyumluluk için Sürücü Yönergeleri bölümünde Blok İmleçleri, Kaydırılabilir İmleçler ve Geriye Dönük Uyumluluk.