Свойство RecordCount (ADO)

  • Статья

Указывает количество записей в объекте Recordset .

Возвращаемое значение

Возвращает значение Long , указывающее количество записей в наборе записей.

Комментарии

Используйте свойство RecordCount , чтобы узнать, сколько записей находится в объекте Recordset . Свойство возвращает значение -1, если ADO не может определить количество записей или если поставщик или тип курсора не поддерживает RecordCount. При чтении свойства RecordCount в закрытом наборе записей возникает ошибка.

Закладки или приблизительное расположение

Если объект Recordset поддерживает закладки или приблизительное расположение, это свойство возвращает точное количество записей в наборе записей. Это свойство возвращает точное число независимо от того, был ли полностью заполнен набор записей.

В отличие от этого, если объект Recordset не поддерживает ни закладки, ни приблизительное расположение, доступ к этому свойству может привести к значительной утечке ресурсов. Утечка происходит потому, что все записи должны быть извлечены и подсчитаны для возврата точного значения RecordCount.

  • adBookmark , связанный с закладками.
  • adApproxPosition относится к приблизительному расположению.

Примечание

В ADO версии 2.8 и более ранних поставщик SQLOLEDB извлекает все записи при использовании курсора на стороне сервера, несмотря на то, что он возвращает значение True для обоих типов Supports (adApproxPosition) и Supports (adBookmark).

Тип курсора объекта Recordset влияет на то, можно ли определить количество записей. Свойство RecordCount возвращает значение -1 для курсора, доступного только для пересылки; фактическое число для статического курсора или курсора набора ключей; и либо -1, либо фактическое число для динамического курсора в зависимости от источника данных.

Применение

Объект Recordset (ADO)

См. также:

Примеры свойств Filter и RecordCount (Visual Basic)
Пример свойств Filter and RecordCount (VC++)
Свойство AbsolutePosition (ADO)
Свойство PageCount (ADO)