다음을 통해 공유


RecordCount 속성(ADO)

Recordset 개체의 레코드 수를 나타냅니다.

Return Value

레코드 집합의 레코드 수를 나타내는 Long 값을 반환합니다.

설명

RecordCount 속성을 사용하여 Recordset 개체에 있는 레코드 수를 확인합니다. 이 속성은 ADO가 레코드 수를 확인할 수 없거나 공급자 또는 커서 유형이 RecordCount를 지원하지 않는 경우 -1을 반환합니다. 닫혀 있는 레코드 집합에서 RecordCount 속성을 읽으면 오류가 발생합니다.

책갈피 또는 대략적 위치 지정

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)