FireDAC.Stan.Option.TFDFetchOptions.RecordCountMode

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property RecordCountMode: TFDRecordCountMode read GetRecordcountMode  write SetRecordCountMode stored IsRCMS default cmVisible;

C++

__property TFDRecordCountMode RecordCountMode = {read=GetRecordcountMode, write=SetRecordCountMode, stored=IsRCMS, default=0};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property published
FireDAC.Stan.Option.pas
FireDAC.Stan.Option.hpp
FireDAC.Stan.Option TFDFetchOptions

Beschreibung

Steuert, wie Datensätze in einer Ergebnismenge gezählt werden sollen.

Mit der Eigenschaft RecordCountMode steuern Sie, wie TFDDataSet die Datensätze in der Ergebnismenge zählt.

Modus

Beschreibung

cmVisible

RecordCount gibt die Anzahl der Datensätze zurück, auf die aktuell über die TDataSet-Navigationsoberfläche zugegriffen werden kann. Beispielsweise kann ein Benutzer auf all diese Datensätze über ein zugeordnetes TDBGrid zugreifen.

  • RecordCountMode verfolgt Datensätze, die in der Datenbank gelöscht/hinzugefügt wurden.
  • Kann nicht für TFDTable im LDW-Modus (Live-Datenfenster) verwendet werden.
  • Hat keinen Overhead.
  • Gibt einen für Endbenutzer brauchbaren Wert an.

cmFetched

RecordCount gibt die Anzahl der gegenwärtig abgerufenen Datensätze zurück.

  • RecordCountMode verfolgt Datensätze, die in der Datenbank gelöscht/hinzugefügt wurden.
  • Kann nicht für TFDTable im LDW-Modus (Live-Datenfenster) verwendet werden.
  • Hat keinen Overhead.
  • Gibt eher eine "Gewichtung" der Datenmenge als einen für Endbenutzer brauchbaren Wert an.

cmTotal

RecordCount gibt die Anzahl der Datensätze zurück, die durch diese Anweisung zurückgegeben werden. Dazu verwendet FireDAC SELECT COUNT(*) FROM (<ursprünglicher SQL-Anweisungstext>).

  • RecordCountMode verfolgt keine Datensätze, die in der Datenbank gelöscht/hinzugefügt wurden. Rufen Sie die Methode Refresh auf, um RecordCountMode zu aktualisieren.
  • Kann für TFDTable im LDW-Modus (Live-Datenfenster) verwendet werden.
  • Hat einen Overhead beim Öffnen der Datenmenge.
  • Gibt annähernd die genaue Anzahl der Datensätze an, bis alle Datenmengendatensätze gelöscht/eingefügt sind.

Der Standardwert ist cmVisible.

Hinweis: Wenn RecordCountMode = cmTotal, kann MySQL den Fehler "Commands out of sync; you can't run this command now" (Anweisung nicht synchronisiert; die Anweisung kann jetzt nicht ausgeführt werden) zurückgeben. Setzen Sie in diesem Fall Mode auf fmFetchAll, oder verwenden Sie cmTotal nicht.

Siehe auch