捲動和擷取資料列 (ODBC)

使用可捲動游標時,應用程式會呼叫 SQLFetchScroll 來定位游標並擷取列。 SQLFetchScroll 支援相對捲動(下一列、前列及相對 n 列)、絕對捲動(第一列、最後一列及 第 n 列),以及以書籤進行定位。 SQLFetchScroll 中的 FetchOrientationFetchOffset 參數指定要擷取哪個列集,如下圖所示。

擷取下一個、先前、第一個和最後的資料列集

擷取下一資料列集、前一資料列集、第一資料列集和最後資料列集

取得絕對、相對及書籤式行集

擷取絕對、相對及書籤資料列集

SQLFetchScroll 將游標定位到指定的列,並回傳從該列開始的列。 若指定的行集與結果集末端重疊,則回傳部分行集。 若指定的行集與結果集起點重疊,通常會回傳結果集中的第一個行集;完整細節請參閱 SQLFetchScroll 函式描述。

在某些情況下,應用程式可能想要定位游標而不取得任何資料。 例如,它可能想測試某列是否存在,或只是取得該列的書籤,而不帶其他資料穿越網路。 為此,它會將 SQL_ATTR_RETRIEVE_DATA 陳述句屬性設為 SQL_RD_OFF。 綁定在書籤欄位的變數(如果有)總是會被更新,無論此陳述屬性的設定為何。

在列集被檢索後,應用程式可以呼叫 SQLSetPos 來定位到列集中的特定列或刷新列集中的列。 欲了解更多使用 SQLSetPos 的資訊,請參閱 「用 SQLSetPos 更新資料」。

備註

ODBC 2 支援捲動功能。x 驅動程式由 SQLExtendedFetch 製作。 欲了解更多資訊,請參閱附錄 G:向下相容驅動程式指引中的 區塊游標、可捲動游標與向下相容 性。