docwiki 번역 [DocWiki 번역] FireDAC.Stan.Option.TFDFetchOptions.RecordCountMode

[Kori]

Docwiki에 있는 "FireDAC.Stan.Option.TFDFetchOptions.RecordCountMode"를 번역한 글: 번역일: 2022년 3월 29일)

위로 가기: [DocWiki 번역] TFDFetchOptions

(이 글은 "설명" 부분만 번역했음. 클래스 선언, 부모, 메소드, 프로퍼티, 프로퍼티, 유닛 정보 등등은 RecordCountMode 원문에 정리된 것을 볼것)

 

설명 (Description)

결과 세트 하나에 담긴 레코드 갯수를 세는 방법을 제어한다.

RecordCountMode 프로퍼티를 사용하면, TFDDataSet이 결과 세트 안에 있는 레코드 갯수를 세는 방법을 제어할 수 있다.

모드(Mode)	설명
cmVisible	RecordCount는 현재 TDataSet의 네이게이션 인터페이스를 통해 접근 가능한 레코드의 갯수를 반환한다. 예를 들어, TDBGrid가 연결되어 있는 경우에 사용자는 아래 레코드들을 접근할 수 있다. RecordCountMode는 해당 데이터셋에서 삭제된/추가된 레코드를 추적한다. TFDTable이 LDW 모드인 경우 적용할 수 없다. 추가 부하가 없다. 최종-사용자가 편리하게 사용할 수 있는 값을 제공한다.
cmFetched	RecordCount는 현재 TDataSet에 담아 온 레코드의 갯수를 반환한다. RecordCountMode는 해당 데이터셋에서 삭제된/추가된 레코드를 추적한다. TFDTable이 LDW 모드인 경우 적용할 수 없다. 추가 부하가 없다. 최종-사용자가 편리하게 사용할 수 있는 값을 제공하지 않고, 데이터셋의 현재 "가중치(weight)"를 제공한다.
cmTotal	RecordCount는 레코드 갯수를 반환한다, 이 갯수는 SQL 명령(command)을 통해 반환한다. 그러기 위해 FireDAC은 SELECT COUNT(*) FROM (<원본 SQL 명령문 텍스트>)을 발행한다. RecordCountMode는 해당 데이터셋에서 삭제된/추가된 레코드를 추적하지 않는다. RecordCountMode를 새로고침 하려면 Refresh 메소드를 호출한다. TFDTable이 LDW 모드인 경우 적용할 수 있다. 데이터셋을 오픈할 때 추가 부하가 있다. 해당 데이터셋에서 레코드가 삭제/추가 되기 전까지는 거의 정확한 레코드 갯수를 제공한다.

기본 값은 cmVisible이다.

주의: MySQL에서는 RecordCountMode = cmTotal 일 때,  "Commands out of sync; you can't run this command now" 에러를 반환한다. 이 경우, fmFetchAll로 설정한다. cmTotal을 사용하면 안된다.

기타 자료 (See Also)

• Data.DB.TDataSet.RecordCount
• [DocWiki 번역] FireDAC.Stan.Option.TFDFetchOptions.Mode