GetRows 方法

   

將 Recordset 對象的多個記錄恢復到數(shù)組中。

語法

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

返回值

返回二維數(shù)組。

參數(shù)

Rows   可選，長整型表達式，指定要檢索記錄數(shù)。默認值為 adGetRowsRest (-1)。

Start   可選，字符串或長整型，計算得到在 GetRows 操作開始處的記錄的書簽。也可使用下列 BookmarkEnum 值。

 

Fields   可選，變體型，代表單個字段名、順序位置、字段名數(shù)組或順序位置號。ADO 僅返回這些字段中的數(shù)據(jù)。

說明

使用 GetRows 方法可將記錄從 Recordset 復制到二維數(shù)組中。第一個下標標識字段，第二個則標識記錄號。當 GetRows 方法返回數(shù)據(jù)時數(shù)組變量將自動調(diào)整到正確大小。

如果不指定 Rows 參數(shù)的值，GetRows 方法將自動檢索 Recordset 對象中的所有記錄。如果請求的記錄比可用記錄多，則 GetRows 僅返回可用記錄數(shù)。

如果 Recordset 對象支持書簽，則可以通過傳送該記錄的 Bookmark 屬性值，來指定 GetRows 方法將從哪個記錄開始檢索數(shù)據(jù)。

如要限制 GetRows 調(diào)用返回的字段，則可以在 Fields 參數(shù)中傳送單個字段名/編號或者字段名/編號數(shù)組。

在調(diào)用 GetRows 后，下一個未讀取的記錄成為當前記錄，或者如果沒有更多的記錄，則 EOF 屬性設置為 True。