`Recordset.GetRows` 是經典 ASP 中**效能最高**的資料提取方法:一次將多筆記錄讀入二維陣列,關閉 Recordset 釋放資料庫連線,後續在記憶體中處理陣列。本文詳細說明語法、參數、回傳結構與實戰範例。
variantArray = recordset.GetRows(Rows, Start, Fields)
| 參數 | 型別 | 說明 | 預設值 |
|---|---|---|---|
| Rows | Long | 要擷取的記錄數 | adGetRowsRest (-1,全部) |
| Start | Variant (String/Long) | 起始書籤或 BookmarkEnum 常數 | adBookmarkCurrent (當前記錄) |
| Fields | Variant | 單一欄位名/索引、或欄位名/索引陣列 | 所有欄位 |
**二維陣列**:`Array(FieldIndex, RecordIndex)`
取得維度上界:`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 = "ID 標題 介紹 "
For i = 0 To ubRec
html = html & "" & _
"" & arr(0, i) & " " & _ ' ID
"" & Server.HTMLEncode(arr(1, i)) & " " & _ ' Title
"" & Server.HTMLEncode(arr(2, i)) & " " & _ ' Intro
" "
Next
html = html & "
"
Response.Write html
%>
arr = rs.GetRows(-1, adBookmarkFirst, Array("Title", "Intro")) ' 只取 Title, Intro
' arr(0, i) = Title, arr(1, i) = Intro
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
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,無需程式邏輯處理 |
`GetRows` 是 ASP 高效資料存取的「黃金標準」:一次讀取、即刻釋放連線、記憶體中高速處理。掌握其二維陣列結構 `(Field, Record)`、書籤定位參數、欄位篩選技巧,能讓 ASP 資料庫操作效能提升數倍,同時簡化代碼邏輯。