GetRows 方法 (ADO)

将 Recordset 对象的多条记录检索到数组中。

语法

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

返回一个变量，其值为二维数组。

行
可选。 GetRowsOptionEnum 值，指示要检索的记录数。默认值为 adGetRowsRest。

启动
可选。字符串值或变量，求值为 GetRows 操作应从其开始的记录的书签。还可以使用 BookmarkEnum 值。

字段
可选。变量，表示单个字段名称或序号位置，或者字段名称数组或序号位置编号数组。 ADO 仅返回这些字段中的数据。

使用 GetRows 方法将记录从 Recordset 复制到二维数组中。第一个下标标识字段，第二个下标标识记录号。当 GetRows 方法返回数据时，数组变量会自动调整为正确的大小。

如果没有为 Rows 参数指定值，GetRows 方法会自动检索 Recordset 对象中的所有记录。如果请求的记录数超过可用记录数，GetRows 仅返回可用记录数。

如果 Recordset 对象支持书签，可通过在 Start 参数中传递该记录的 Bookmark 属性的值来指定 GetRows 方法应从哪条记录开始检索数据。

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

调用 GetRows 后，下一条未读记录将成为当前记录，或者如果没有更多记录，EOF 属性设置为 True。