萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP 程式設計

ASP Recordset.GetRows 完整指南:將資料集高效轉為陣列的最佳實踐

前言

`Recordset.GetRows` 是經典 ASP 中**效能最高**的資料提取方法:一次將多筆記錄讀入二維陣列,關閉 Recordset 釋放資料庫連線,後續在記憶體中處理陣列。本文詳細說明語法、參數、回傳結構與實戰範例。

語法與參數

variantArray = recordset.GetRows(Rows, Start, Fields)
參數型別說明預設值
RowsLong要擷取的記錄數adGetRowsRest (-1,全部)
StartVariant (String/Long)起始書籤或 BookmarkEnum 常數adBookmarkCurrent (當前記錄)
FieldsVariant單一欄位名/索引、或欄位名/索引陣列所有欄位

BookmarkEnum 常數

  • `adBookmarkCurrent` (0) — 當前記錄 (預設)
  • `adBookmarkFirst` (1) — 第一筆記錄
  • `adBookmarkLast` (2) — 最後一筆記錄

回傳陣列結構

**二維陣列**:`Array(FieldIndex, RecordIndex)`

  • **第一維 (FieldIndex)**:欄位索引 (0-based),對應 `Fields` 集合順序或 `Fields` 參數指定順序。
  • **第二維 (RecordIndex)**:記錄索引 (0-based),對應擷取的第 N 筆記錄。

取得維度上界:`UBound(arr, 1)` = 最大欄位索引,`UBound(arr, 2)` = 最大記錄索引。

完整實戰範例

<%
' 分類表 T_Cate: ID (PK), Title, Intro
Dim rs, arr, ubRec, i, html

Set rs = conn.Execute("SELECT ID, Title, Intro FROM T_Cate ORDER BY ID")
' 一次性讀取所有記錄到陣列
arr = rs.GetRows()
rs.Close
Set rs = Nothing  ' 盡早釋放資料庫資源!

' 遍歷陣列輸出
ubRec = UBound(arr, 2)  ' 記錄數上界
html = ""
For i = 0 To ubRec
    html = html & "" & _
        "" & _  ' ID
        "" & _  ' Title
        "" & _  ' Intro
        ""
Next
html = html & "
ID標題介紹
" & arr(0, i) & "" & Server.HTMLEncode(arr(1, i)) & "" & Server.HTMLEncode(arr(2, i)) & "
" Response.Write html %>

進階用法

1. 僅擷取指定欄位

arr = rs.GetRows(-1, adBookmarkFirst, Array("Title", "Intro"))  ' 只取 Title, Intro
' arr(0, i) = Title, arr(1, i) = Intro

2. 分頁式擷取 (大資料集分批處理)

Const PAGE_SIZE = 100
Dim pageNum, startBookmark
pageNum = 0
startBookmark = adBookmarkFirst

Do
    arr = rs.GetRows(PAGE_SIZE, startBookmark)
    If IsEmpty(arr) Then Exit Do  ' 無資料
    
    ' 處理當前批次 arr
    ProcessBatch arr
    
    pageNum = pageNum + 1
    ' 下一批次從最後一筆的下一筆開始 (需支援書籤的游標)
    ' 實務上較簡單:直接用 AbsolutePage 配合 PageSize
Loop

3. 轉換為更友善的結構:陣列的陣列 (Array of Dictionaries)

Function RecordsetToArrayOfDicts(rs)
    Dim arr, ubRec, ubField, i, j, dict, result, re
    arr = rs.GetRows()
    If IsEmpty(arr) Then Set RecordsetToArrayOfDicts = Array() : Exit Function
    
    ubRec = UBound(arr, 2)
    ubField = UBound(arr, 1)
    ReDim result(ubRec)
    
    Set re = New RegExp  ' 用於欄位名清理 (可選)
    re.Global = True
    re.Pattern = "[^a-zA-Z0-9_]"
    
    For i = 0 To ubRec
        Set dict = Server.CreateObject("Scripting.Dictionary")
        For j = 0 To ubField
            Dim fieldName : fieldName = rs.Fields(j).Name
            ' 可選:清理欄位名作為 Key
            ' fieldName = re.Replace(fieldName, "_")
            dict.Add fieldName, arr(j, i)
        Next
        Set result(i) = dict
    Next
    RecordsetToArrayOfDicts = result
End Function

效能優勢量化

方法資料庫往返記憶體佔用適用場景
GetRows + 陣列處理1 次低 (純資料)中小資料集、高頻讀取、需快速釋放連線
`Do While Not rs.EOF` 逐筆1 次 (但連線持有久)低串流處理、超大資料集 (避免記憶體爆炸)
`GetString`1 次低 (字串)直接輸出 HTML 表格/CSV,無需程式邏輯處理

常見陷阱與注意事項

  1. 游標類型必須支援書籤:`adOpenKeyset (1)`、`adOpenStatic (3)`、`adOpenDynamic (2)`。`adOpenForwardOnly (0)` **不支援** `GetRows` 的 `Start` 參數書籤定位。
  2. 呼叫後游標位置:下一筆未讀取記錄成為當前記錄;若已讀完,`EOF = True`。
  3. 資料型別保留:陣列元素保留原始 ADO 型別 (如 `adInteger`、`adDate`),VBScript 自動轉型,但 `Null` 需 `IsNull()` 檢查。
  4. 二維陣列維度順序:`(Field, Record)` 而非常見的 `(Record, Field)`,遍歷時外層迴圈跑 Record 索引 (第二維)。
  5. 大資料集記憶體風險:10 萬筆 × 50 欄位 ≈ 數百 MB 陣列,建議分頁 `GetRows` 或改用串流處理。

結語

`GetRows` 是 ASP 高效資料存取的「黃金標準」:一次讀取、即刻釋放連線、記憶體中高速處理。掌握其二維陣列結構 `(Field, Record)`、書籤定位參數、欄位篩選技巧,能讓 ASP 資料庫操作效能提升數倍,同時簡化代碼邏輯。

copyright © 萬盛學電腦網 all rights reserved