捲動與擷取資料列 (ODBC)

使用可捲動資料指標時，應用程式會呼叫 SQLFetchScroll 以定位資料指標並擷取資料列。 SQLFetchScroll 支援相對捲動 (下一列、上一列和相對 n 列)、絕對捲動 (第一列、最後一列和第 n 列)，以及依書籤定位。 SQLFetchScroll 中的 FetchOrientation 與 FetchOffset 引數會指定要擷取的資料列集，如下圖所示。

提取下一個、上一個、第一個和最後一個資料列集

擷取絕對、相對、加上書籤的資料列集

SQLFetchScroll 會將資料指標定位至特定資料列，並傳回以該資料列開頭的資料列集中的資料列。 如果指定資料列集與結果集的結尾重疊，會傳回部分資料列集。 如果指定資料列集與結果集的開頭重疊，則通常會傳回結果集中第一個資料列集。如需完整詳細資料，請參閱 SQLFetchScroll 函式說明。

在部分情況下，應用程式可能會定位資料指標，但不擷取任何資料。 舉例來說，應用程式可能想測試特定資料列是否存在，或者只取得特定資料列的書籤，而不需擷取網路中其他資料。 為了達成這個目標，應用程式會將 SQL_ATTR_RETRIEVE_DATA 陳述式屬性設定為 SQL_RD_OFF。 繫結至書籤資料行的變數 (如有) 一律會處於最新狀態，不論這個陳述式屬性如何設定。

擷取資料列集之後，應用程式可以呼叫 SQLSetPos，以定位至資料列集中的特定資料列，或重新整理資料列集中的資料列。 如需深入了解如何使用 SQLSetPos，請參閱使用 SQLSetPos 更新資料。

注意

ODBC 2.x 驅動程式可使用 SQLExtendedFetch 支援捲動功能。 如需詳細資訊，請參閱〈附錄 G：回溯相容性的驅動程式指導方針〉中的區塊游標、可捲動的資料指標和回溯相容性。