將 Recordset 物件的多個記錄檢索到陣列中。

語法

array = recordset.GetRows( Rows, Start, Fields )

返回 Variant，其值為二維陣列。

引數

Rows 可選。GetRowsOptionEnum 值，指示要檢索的記錄數。預設值為 adGetRowsRest。

Start 可選。String 值或 Variant，計算 GetRows 操作開始處的記錄的書籤。還可以使用 BookmarkEnum 值。

Fields 可選。Variant，表示單個欄位名或序號位置，或者欄位名陣列或序號位置編號。ADO 僅返回這些欄位中的資料。

說明

使用 GetRows 方法將 Recordset 中的記錄複製到二維陣列中。第一個下標標識欄位，第二個下標標識記錄編號。當 GetRows 方法返回資料時，array 變數將自動調整到正確大小。

如果未指定 Rows 引數的值，GetRows 方法將自動檢索 Recordset 物件中的所有記錄。如果請求的記錄多於可用的記錄，GetRows 僅返回可用的記錄數目。

如果 Recordset 物件支援書籤，可以透過在 Start 引數中傳遞該記錄的 Bookmark 屬性的值來指定 GetRows 方法從哪一個記錄開始檢索資料。

如果要限制 GetRows 呼叫返回的欄位，可以在 Fields 引數中傳遞單個欄位名/編號，或者欄位名/編號的陣列。

在呼叫 GetRows 後，下一個未讀取的記錄成為當前記錄。如果沒有其他記錄，EOF 屬性將被設定為 True。