捲動與提取資料列
若要使用可捲動的資料指標,ODBC 應用程式必須:
使用 SQLSetStmtAttr 設定資料指標的功能。
使用 SQLExecute 或 SQLExecDirect 開啟資料指標。
使用 SQLFetch 或 SQLFetchScroll 捲動與提取資料列。
SQLFetch 和 SQLFetchSroll 都可以一次提取資料列的區塊。 傳回的資料列數目會使用 SQLSetStmtAttr 設定 SQL_ATTR_ROW_ARRAY_SIZE 參數來指定。
ODBC 應用程式可以使用 SQLFetch,透過順向資料指標提取。
SQLFetchScroll 用來在資料指標周圍捲動。 除了相對提取 (從目前資料列集開頭提取資料列集 n 資料列) 和絕對提取 (提取資料列 n 開始的資料列集) 之外,SQLFetchScroll 還支援提取下一個、上一個、第一個和最後一個資料列集。 如果 n 在絕對提取中為負數,資料列會從結果集的結尾開始計數。 資料列的絕對提取 -1 表示提取從結果集的最後一個資料列開始的資料列集。
僅針對其區塊資料指標功能 (例如報表) 使用 SQLFetchScroll 的應用程式可能會通過一次結果集,僅使用選項來提取下一個資料列集。 在另一方面,螢幕式的應用程式可以使用 SQLFetchScroll 的所有功能。 如果應用程式將資料列集大小設定為顯示在螢幕上的資料列數目,並將螢幕緩衝區繫結至結果集,則可以直接轉譯捲軸作業來呼叫 SQLFetchScroll。
捲軸作業 |
SQLFetchScroll 捲動選項 |
---|---|
向上捲動一頁 |
SQL_FETCH_PRIOR |
向下捲動一頁 |
SQL_FETCH_NEXT |
向上捲動一行 |
包含 FetchOffset 的 SQL_FETCH_RELATIVE 等於 -1 |
向下捲動一行 |
包含 FetchOffset 的 SQL_FETCH_RELATIVE 等於 1 |
捲動方塊到頂端 |
SQL_FETCH_FIRST |
捲動方塊到底部 |
SQL_FETCH_LAST |
隨機捲動方塊位置 |
SQL_FETCH_ABSOLUTE |