GetRows 方法 (ADO)

适用于:Access 2013、Office 2013

用于将 Recordset 对象的多个记录检索到数组中。

语法

阵 列 = recordset。GetRows (开始字段 )

返回值

返回一个变量,其值是二维数组。

参数

参数 说明
Rows 可选。 GetRowsOptionEnum 值,指示要检索的记录数。 默认值为 adGetRowsRest
Start 可选。 字符串型 值或 变量 ,变量计算得出的值为应从该处开始 GetRows 操作的记录的书签。 也可以使用 BookmarkEnum 值。
Fields 可选。 变量 ,代表单个字段名或序号位置,或一个含一些字段名或序号位置编号的数组。 ADO 仅返回这些字段中的数据。

备注

使用 GetRows 方法可以将 Recordset 中的记录复制到一个二维数组中。 第一个下标标识字段,第二个下标标识记录号。 当 GetRows 方法返回数据时,array 变量的维度将自动设为正确的大小。

如果不指定 Rows 参数的值,GetRows 方法将自动检索 Recordset 对象中的所有记录。 如果请求的记录数大于可用记录数,则 GetRows 仅返回可用数目的记录。

如果 Recordset 对象支持书签,则可以指定 GetRows 方法应从哪个记录开始检索数据,方法是在 Start 参数中传递该记录的 Bookmark 属性的值。

如果要限制 GetRows 调用返回的字段数,可以在 Fields 参数中传递单个字段名/编号或一个含多个字段名/编号的数组。

调用 GetRows 之后,下一个未读取的记录成为当前记录,如果没有更多记录,则 EOF 属性设置为 True