NextRecordset 方法

功能

通过执行一系列命令清除当前 Recordset 对象并返回下一个 Recordset。

语法

Set recordset2 = recordset1.NextRecordset( RecordsAffected )

返回值

返回 Recordset 对象。在语法模型中,recordset1 和 recordset2 可以是相同的 Recordset 对象,也可以使用单独的对象。当使用单独的 Recordset 对象时,在调用 NextRecordset 后重置原来 Recordset (recordset1) 上的 ActiveConnection 属性将产生错误。

参数

RecordsAffected   可选。Long 变量,提供者向其返回当前操作影响的记录数目。

注意   此参数仅返回受操作影响的记录数目,它不会从用于生成 Recordset 的选择语句中返回记录的计数。

说明

使用 NextRecordset 方法返回复合命令语句中下一条命令的结果,或者返回多个结果的存储过程的结果。如果使用 Command 的 Execute 方法或者 Recordset 的 Open 方法打开基于复合命令语句(例如“Select * FROM table1;Select * FROM table2”)的 Recordset 对象,ADO 仅执行第一个命令并将结果返回到 recordset。要访问语句中后续命令的结果,请调用 NextRecordset 方法。

只要有其他的结果,并且包含复合语句的 Recordset 未被跨进程边界调度,那么 NextRecordset 方法将继续返回 Recordset 对象。如果以行返回命令没有返回记录,返回的 Recordset 对象将为空。通过验证 BOF 和 EOF 属性均为 True 来测试这种情况。如果不是以行返回的命令执行成功,返回的 Recordset 对象将被关闭,可以通过测试 Recordset 上的 State 属性验证这种情况。没有其他结果时,recordset 将被设置为 Nothing。

远程数据服务用法   NextRecordset 方法在客户端 Recordset 对象上无效。

如果在立即更新模式下进行编辑,调用 NextRecordset 方法将产生错误。请先调用 Update 或 CancelUpdate 方法。

若要通过填充 Parameters 集合或者通过使用原来的 Open 或 Execute 调用传送数组为复合语句中的多个命令传送参数,这些参数在集合或数组中的次序必须与它们在命令序列中各自命令的次序相同。在读取输出参数值之前必须完成所有结果的读取。

在调用 NextRecordset 方法时,ADO 仅执行语句中的下一条命令。如果在单步执行整个命令语句之前显式关闭 Recordset 对象,ADO 将不再执行其余的命令。

Dnawo注:

此方法对ACCESS似乎无效!

评论: 1 | 引用: 0 | 查看次数: 4654
发表评论
登录后再发表评论!