Posouvání a načítání řádků
platí pro:
SQL ServerAzure SQL Databaseazure SQL Managed InstanceAzure Synapse AnalyticsPlatform Platform System (PDW)
Pokud chcete použít posouvání kurzoru, musí aplikace ODBC:
Nastavte možnosti kurzoru pomocí SQLSetStmtAttr.
Otevřete kurzor pomocí SQLExecute nebo SQLExecDirect.
Posouvání a načítání řádků pomocí sqlFetch nebo SQLFetchScroll.
SQLFetch i SQLFetchScroll mohou najednou načítat bloky řádků. Počet vrácených řádků je určen pomocí SQLSetStmtAttr k nastavení parametru SQL_ATTR_ROW_ARRAY_SIZE.
Aplikace ODBC můžou pomocí sqlFetch načíst kurzorem jen dopředu.
SQLFetchScroll slouží k posouvání kurzoru. SQLFetchScroll podporuje načtení dalších, předchozích, prvních a posledních sad řádků kromě relativního načítání (načtení sady řádků n řádků od začátku aktuální sady řádků) a absolutního načítání (načtení sady řádků počínaje řádkem n). Pokud n je záporná v absolutním načtení, řádky se počítají z konce sady výsledků. Absolutní načtení řádku -1 znamená načtení sady řádků, která začíná posledním řádkem v sadě výsledků.
Aplikace, které používají SQLFetchScroll pouze pro funkce blokového kurzoru, jako jsou sestavy, budou pravděpodobně procházet sadu výsledků jednou, a to pouze pomocí možnosti načíst další sadu řádků. Aplikace založené na obrazovce na druhé straně mohou využívat všechny možnosti SQLFetchScroll. Pokud aplikace nastaví velikost sady řádků na počet řádků zobrazených na obrazovce a vytvoří vazbu vyrovnávací paměti obrazovky k sadě výsledků, může operace posuvníku přeložit přímo na volání SQLFetchScroll.
| Operace posuvníku | Možnost posouvání SQLFetchScroll |
|---|---|
| Page up | SQL_FETCH_PRIOR |
| Page down | SQL_FETCH_NEXT |
| Řadit | SQL_FETCH_RELATIVE s hodnotou FetchOffset rovnou -1 |
| Řádek dolů | SQL_FETCH_RELATIVE s hodnotou FetchOffset rovnou 1 |
| Scroll box to top | SQL_FETCH_FIRST |
| Posunout pole dolů | SQL_FETCH_LAST |
| Pozice náhodného posuvníku | SQL_FETCH_ABSOLUTE |