RecordCount 属性 (ADO)

指示 Recordset 对象中的记录数

返回值

返回一个 Long 值,该值指示 Recordset 中的记录数。

备注

使用 RecordCount 属性找出 Recordset 对象中有多少条记录。 当 ADO 无法确定记录数或者提供程序或游标类型不支持 RecordCount 时,该属性返回 -1。 读取已关闭 Recordset 上的 RecordCount 属性会导致错误。

书签或近似定位

如果 Recordset 对象确实支持书签或近似定位,则此属性返回 Recordset 中的确切记录数。 无论 Recordset 是否已完全填充,此属性都会返回确切的数字。

相反,如果 Recordset 对象不支持书签或近似定位,则访问此属性可能会大量消耗资源。 因为必须检索和计数所有记录才能返回准确的 RecordCount 值,所以会发生耗尽的情况。

  • adBookmark 与书签相关。
  • adApproxPosition 与近似定位有关。

注意

在 ADO 版本 2.8 和更早版本中,SQLOLEDB 提供程序在使用服务器端游标时获取所有记录,尽管它对 Supports (adApproxPosition) 和 Supports (adBookmark) 都返回 True。

Recordset 对象的游标类型影响是否可以确定记录数。 对于只进游标,RecordCount 属性将返回 -1;静态或键集游标的实际计数;以及 -1 或动态游标的实际计数,具体取决于数据源。

应用于

记录集对象 (ADO)

另请参阅

Filter 和 RecordCount 属性示例 (VB)
Filter 和 RecordCount 属性示例 (VC++)
AbsolutePosition 属性 (ADO)
PageCount 属性 (ADO)