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。