Przewijanie i pobieranie wierszy
Dotyczy:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
Aby użyć kursora przewijanego, aplikacja ODBC musi:
Ustaw możliwości kursora przy użyciu SQLSetStmtAttr.
Otwórz kursor przy użyciu SQLExecute lub SQLExecDirect.
Przewiń i pobierz wiersze przy użyciu sqlFetch lub SQLFetchScroll.
Zarówno SQLFetch, jak i SQLFetchScroll mogą pobierać bloki wierszy naraz. Liczba zwracanych wierszy jest określana przy użyciu SQLSetStmtAttr w celu ustawienia parametru SQL_ATTR_ROW_ARRAY_SIZE.
Aplikacje ODBC mogą używać SQLFetch do pobierania kursora tylko do przodu.
SQLFetchScroll służy do przewijania kursora. sqlFetchScroll obsługuje pobieranie następnych, wcześniejszych, pierwszych i ostatnich zestawów wierszy oprócz względnego pobierania (pobieranie zestawu wierszy n wierszy od początku bieżącego zestawu wierszy) i pobieranie bezwzględne (pobieranie zestawu wierszy rozpoczynających się od wiersza n). Jeśli n jest ujemna w bezwzględnym pobieraniu, wiersze są liczone od końca zestawu wyników. Bezwzględne pobieranie wierszy -1 oznacza pobranie zestawu wierszy rozpoczynającego się od ostatniego wiersza w zestawie wyników.
Aplikacje korzystające z SQLFetchScroll tylko dla funkcji kursora blokowego, takich jak raporty, mogą przechodzić przez zestaw wyników pojedynczo, używając tylko opcji pobierania następnego zestawu wierszy. Z drugiej strony aplikacje oparte na ekranach mogą korzystać ze wszystkich możliwości SQLFetchScroll. Jeśli aplikacja ustawia rozmiar zestawu wierszy na liczbę wierszy wyświetlanych na ekranie i wiąże ekranu z zestawem wyników, może przetłumaczyć operacje paska przewijania bezpośrednio na wywołania SQLFetchScroll.
| Operacja paska przewijania | Opcja przewijania elementu SQLFetchScroll |
|---|---|
| Strona w górę | SQL_FETCH_PRIOR |
| Strona w dół | SQL_FETCH_NEXT |
| Ustawić | SQL_FETCH_RELATIVE z zestawem FetchOffset równym -1 |
| Linia w dół | SQL_FETCH_RELATIVE z zestawem FetchOffset równym 1 |
| Przewiń pole do góry | SQL_FETCH_FIRST |
| Przewiń pole do dołu | SQL_FETCH_LAST |
| Losowe położenie pola przewijania | SQL_FETCH_ABSOLUTE |
W tej sekcji
- wiersze zakładek w ODBC