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。