Sorok görgetése és lekérése (ODBC)

Görgethető kurzor használatakor az alkalmazások meghívják az SQLFetchScrollt a kurzor elhelyezéséhez és a sorok beolvasásához. Az SQLFetchScroll támogatja a relatív görgetést (következő, előző és relatív n sor), az abszolút görgetést (az első, az utolsó és az n sort), valamint a könyvjelzővel való elhelyezést. Az SQLFetchScrollFetchOrientation és FetchOffset argumentumai határozzák meg, hogy melyik sorhalmazt kell beolvasni az alábbi ábrákon látható módon.

Következő, Előző, Első és Utolsó sorhalmazok lekérése

Abszolút, relatív és könyvjelzős sorhalmazok beolvasása

Az SQLFetchScroll a kurzort a megadott sorra pozinálja, és visszaadja a sorhalmaz sorait az adott sortól kezdve. Ha a megadott sorhalmaz átfedésben van az eredményhalmaz végén, a rendszer részleges sorhalmazt ad vissza. Ha a megadott sorhalmaz átfedésben van az eredményhalmaz elején, a rendszer általában az eredményhalmaz első sorhalmazát adja vissza; A részletekért tekintse meg az SQLFetchScroll függvény leírását.

Bizonyos esetekben előfordulhat, hogy az alkalmazás adatok beolvasása nélkül szeretné elhelyezni a kurzort. Előfordulhat például, hogy szeretné tesztelni, hogy létezik-e sor, vagy csak le szeretné szerezni a sor könyvjelzőjét anélkül, hogy más adatokat hozna át a hálózaton. Ehhez a SQL_ATTR_RETRIEVE_DATA utasítás attribútumot SQL_RD_OFF állítja be. A könyvjelző oszlophoz kötött változó (ha van ilyen) mindig frissül, függetlenül az utasítás attribútumának beállításától.

A sorhalmaz lekérése után az alkalmazás meghívhatja az SQLSetPos-t , hogy a sorhalmaz egy adott sorához helyezzen, vagy frissítse a sorhalmaz sorait. Az SQLSetPos használatával kapcsolatos további információkért lásd: Adatok frissítése AZ SQLSetPos használatával.

Megjegyzés:

Az ODBC 2.x illesztők a görgetést az SQLExtendedFetch által támogatják. További információkért lásd a Blokk kurzorok, görgethető kurzorok és visszamenőleges kompatibilitás részt a G függelékben: Illesztőprogramok útmutatója a visszamenőleges kompatibilitáshoz.