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 或動態資料指標的實際計數，視資料來源而定。

套用至

Recordset 物件 (ADO)

另請參閱

Filter 和 RecordCount 屬性範例 (VB)
Filter 和 RecordCount 屬性範例 (VC++)
AbsolutePosition 屬性 (ADO)
PageCount 屬性 (ADO)