FireDAC.Stan.Option.TFDFetchOptions.RecordCountMode

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

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

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
property published
FireDAC.Stan.Option.pas
FireDAC.Stan.Option.hpp
FireDAC.Stan.Option TFDFetchOptions

Description

Contrôle la manière de compter les enregistrements dans un ensemble de résultats.

Utilisez la propriété RecordCountMode pour contrôler la manière dont TFDDataSet compte les enregistrements dans l'ensemble de résultats.

Mode

Description

cmVisible

RecordCount renvoie le nombre d'enregistrements actuellement accessibles via l'interface de navigation TDataSet. Par exemple, tous ces enregistrements sont accessibles pour un utilisateur en utilisant le TDBGrid associé.

cmFetched

RecordCount renvoie le nombre d'enregistrements extraits au moment en cours.

  • RecordCountMode suit les enregistrements supprimés/ajoutés à l'ensemble de données.
  • Il ne s'applique pas à TFDTable en mode Fenêtre Données dynamiques.
  • Sans charge système.
  • Donne le "poids" d'un ensemble de données en cours, plutôt qu'apporter un côté pratique à l'utilisateur final.

cmTotal

RecordCount renvoie le nombre d'enregistrements qui seront renvoyés par la commande. Pour ce faire, FireDAC émet SELECT COUNT(*) FROM (<texte de la commande SQL d'origine>).

  • RecordCountMode ne suit pas les enregistrements supprimés/ajoutés à l'ensemble de données. Pour actualiser RecordCountMode, appelez la méthode Refresh.
  • S'applique à TFDTable en mode Fenêtre Données dynamiques.
  • Présente une charge système lors de l'ouverture de l'ensemble de données.
  • Donne presque le nombre exact d'enregistrements jusqu'à ce que les enregistrements de l'ensemble de données soient supprimés / insérés.

La valeur par défaut est cmVisible.

Remarque : MySQL peut renvoyer l'erreur "Commands out of sync; you can't run this command now" lorsque RecordCountMode =cmTotal. Dans ce cas, définissez le mode sur fmFetchAll ou n'utilisez pas cmTotal.

Voir aussi