Posouvání a načítání řádků (ODBC)

Při použití posuvného kurzoru aplikace volají SQLFetchScroll k umístění kurzoru a načtení řádků. SQLFetchScroll podporuje relativní posouvání (další, předchozí a relativní n řádků), absolutní posouvání (první, poslední a řádek n) a umístění podle záložky. Argumenty FetchOrientation a FetchOffset v sqlFetchScroll určují, které sady řádků se mají načíst, jak je znázorněno v následujících diagramech.

Načítání následujících, předchozích, prvních a posledních sad řádků

Načítání sad řádků s absolutními, relativními a záložkovými hodnotami

SQLFetchScroll umístí kurzor na zadaný řádek a vrátí řádky v sadě řádků začínající tímto řádkem. Pokud se zadaná sada řádků překrývají na konci sady výsledků, vrátí se částečná sada řádků. Pokud se zadaná sada řádků překrývají na začátku sady výsledků, vrátí se obvykle první sada řádků v sadě výsledků; Úplné podrobnosti naleznete v popisu funkce SQLFetchScroll .

V některých případech může aplikace chtít umístit kurzor bez načtení dat. Může například chtít otestovat, jestli řádek existuje, nebo jenom získat záložku pro řádek bez přenesení dalších dat do sítě. K tomu nastaví atribut příkazu SQL_ATTR_RETRIEVE_DATA na SQL_RD_OFF. Proměnná vázaná na sloupec záložky (pokud existuje) se vždy aktualizuje bez ohledu na nastavení tohoto atributu příkazu.

Po načtení sady řádků může aplikace volat SQLSetPos k umístění na konkrétní řádek v sadě řádků nebo aktualizovat řádky v sadě řádků. Další informace o použití SQLSetPos naleznete v tématu Aktualizace dat pomocí SQLSetPos.

Poznámka:

Posouvání je podporováno v ovladačích ODBC 2.x pomocí funkce SQLExtendedFetch. Další informace naleznete v části Block Cursors, Scrollable Cursors, and Backward Compatibility v Příloze G: Pokyny pro ovladače k zpětné kompatibilitě.