GetRows 方法 (ADO)

Recordset 物件的多個記錄擷取到陣列中。

語法

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

傳回值

傳回 Variant ,其值為二維陣列。

參數

資料列
選擇性。 GetRowsOptionEnum值,指出要擷取的記錄數目。 預設值為 adGetRowsRest

開始
選擇性。 評估為GetRows作業開始之記錄書簽的String值或Variant。 您也可以使用 BookmarkEnum 值。

欄位
選擇性。 代表單一功能變數名稱或序數位位置的 Variant ,或功能變數名稱或序數位的陣列。 ADO 只會傳回這些欄位中的資料。

備註

使用 GetRows 方法,將 記錄從 Recordset 複製到二維陣列。 第一個下標會識別欄位,而第二個則識別記錄號碼。 當 GetRows方法傳回資料時,陣列變數會自動調整為正確的大小。

如果您未指定 Rows 引數的值, GetRows 方法會自動擷取 Recordset 物件中的所有記錄。 如果您要求的記錄數目超過可用, GetRows 只會傳回可用的記錄數目。

如果Recordset物件支援書簽,您可以指定GetRows方法應該藉由在Start引數中傳遞該記錄的Bookmark屬性值,開始擷取資料。

如果您想要限制 GetRows 呼叫傳回的欄位,您可以在 Fields 引數中傳遞單一功能變數名稱/數位或功能變數名稱/數位陣列。

呼叫 GetRows之後,下一筆未讀取的記錄會變成目前記錄,或者如果沒有其他記錄, EOF 屬性就會設定為 True

套用至

Recordset 物件 (ADO)

另請參閱

GetRows 方法範例 (VB)
GetRows 方法範例 (VC++)