RecordCount 属性 (ADO)

指示 Recordset 对象中的记录数。

返回值

返回一个 Long 值,该值指示记录集中 记录数

言论

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

书签或近似定位

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

相比之下,如果 Recordset 对象 支持书签或近似定位,则访问此属性可能会对资源产生大量消耗。 清空发生的原因是必须检索和计数所有记录才能返回准确的 RecordCount 值。

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

注意

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

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

适用于

Recordset 对象 (ADO)

另请参阅

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