GetRows 方法 (ADO)
將 Recordset 物件的多個記錄擷取到陣列中。
語法
array = recordset.GetRows(Rows, Start, Fields )
傳回值
傳回其值為二維陣列的 Variant。
參數
資料列
選擇性。 GetRowsOptionEnum 值，會指出要擷取的記錄數目。 預設值為 adGetRowsRest。
開始
選擇性。 評估為應作為 GetRows 作業起始記錄書簽的字串值或變體。 您也可以使用 BookmarkEnum 值。
欄位
選擇性。 代表單一欄位名稱或序數位置、或代表欄位名稱陣列或序數位置號碼陣列的變體。 ADO 只會傳回這些欄位中的資料。
備註
使用 GetRows 方法，將記錄從 Recordset 複製到二維陣列。 第一個下標可識別欄位，第二個下標可識別記錄號碼。 當 GetRows 方法傳回資料時，陣列變數會自動將為度調整為正確大小。
如果您未指定 Rows 引數的值，則 GetRows 方法會自動擷取 Recordset 物件中的所有記錄。 如果您要求的記錄數目超過可用數目，則 GetRows 只會傳回可用的記錄數目。
如果 Recordset 物件支援書簽，您可以在 Start 引數中傳遞該記錄的 Bookmark 屬性值，以指定 GetRows 方法應該開始擷取資料的記錄。
如果您想要限制 GetRows 呼叫傳回的欄位，則可以在 Fields 引數中傳遞單一欄位名稱/號碼或欄位名稱陣列/號碼陣列。
在呼叫 GetRows 之後，下一筆未讀取的記錄會變成目前的記錄，或者，如果已沒有其他記錄，則 EOF 屬性會設定為 True。