共用方式為

捲動與提取資料列

  • 發行項

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics Platform System (PDW)

若要使用可捲動的資料指標，ODBC 應用程式必須：

  • 使用 SQLSetStmtAttr 設定資料指標功能。

  • 使用 SQLExecute 或 SQLExecDirect 開啟資料指標。

  • 使用 SQLFetch 或 SQLFetchScroll 捲動和擷取 資料列。

SQLFetch 和 SQLFetchSroll 都可以一次擷取資料列區塊。 傳回的資料列數目是使用 SQLSetStmtAttr 來設定SQL_ATTR_ROW_ARRAY_SIZE參數所指定。

ODBC 應用程式可以使用 SQLFetch 透過向前資料指標進行擷取 。

SQLFetchScroll 可用來捲動游標。 SQLFetchScroll 除了相對擷取之外，還支援擷取下一個、先前、第一個和最後一個資料列集（從目前資料列集開頭擷取資料列集 n 個數據列），以及絕對擷取 （從第 n 列開始 擷取資料列集）。 如果絕對擷取的 n 為負數，資料列會從結果集的結尾開始計數。 資料列 -1 的絕對擷取表示擷取以結果集中最後一個資料列開頭的資料列集。

若應用程式僅使用 SQLFetchScroll 的區塊游標功能 (例如報表)，則可能會僅使用選項來擷取下個資料列集，一次傳遞結果集。 另一方面，螢幕式應用程式可利用 SQLFetchScroll 的所有功能。 如果應用程式將資料列集大小設為在螢幕上顯示的資料列數目，並繫結螢幕緩衝區至結果集，則可直接轉譯捲軸作業來呼叫 SQLFetchScroll。

捲軸作業 SQLFetchScroll 捲動選項
向上捲動一頁 SQL_FETCH_PRIOR
向下捲動一頁 SQL_FETCH_NEXT
向上捲動一行 FetchOffset 等於 -1 的 SQL_FETCH_RELATIVE
向下捲動一行 FetchOffset 等於 1 的 SQL_FETCH_RELATIVE
將方塊捲動到頂端 SQL_FETCH_FIRST
向下捲動方塊 SQL_FETCH_LAST
隨機捲動方塊位置 SQL_FETCH_ABSOLUTE

本節內容

另請參閱

使用資料指標 （ODBC）