FireDAC.Stan.Option.TFDFetchOptions.Mode

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Mode: TFDFetchMode read GetMode write SetMode  stored IsMS default fmOnDemand;

C++

__property TFDFetchMode Mode = {read=GetMode, write=SetMode, stored=IsMS, default=1};

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 dont les données sont extraites.

Utilisez la propriété Mode pour contrôler la manière dont les enregistrements de l'ensemble de résultats doivent être extraits dans le stockage de données interne FireDAC.

Mode

Description

fmManual

Les enregistrements ne sont pas extraits automatiquement par FireDAC. Un programmeur doit écrire le code pour extraire les enregistrements aux moments appropriés, en utilisant les méthodes suivantes :

  • FetchAll pour extraire tous les enregistrements.
  • GetNextPacket pour extraire le prochain ensemble de résultats (paquet) contenant des enregistrements RowsetSize.

fmOnDemand

Les enregistrements sont extraits automatiquement par FireDAC lorsqu'ils sont demandés pour la navigation ou pour d'autres méthodes d'ensembles de données. A chaque demande, FireDAC extrait un ou plusieurs ensembles d'enregistrements, contenant des enregistrements RowsetSize. Ce mode permet d'ouvrir de grands ensembles de résultats sans retard significatif, de la même manière que le mode fmAll. Mais la durée totale d'extraction de l'ensemble des enregistrements est supérieure à celle du mode fmAll. Par exemple, sur Microsoft SQL Server, le curseur statique côté serveur est utilisé.

fmAll

Tous les enregistrements de l'ensemble de résultats sont extraits automatiquement par FireDAC au moment de l'appel à Open de l'ensemble de données. Sur un grand ensemble de résultats, cela peut prendre du temps, mais la navigation à travers un ensemble de données est rapide car tous les enregistrements sont stockés dans un stockage de données interne FireDAC. Pour de nombreux SGBD, tels que Microsoft SQL Server, MySQL Server, Sybase SQL Anywhere :

  • Il libère le tampon d'ensembles de résultats du client et autorise l'exécution de la prochaine commande renvoyant des ensembles de résultats.
  • Il fournit des performances d'extraction maximales. Par exemple, sur Microsoft SQL Server, le curseur avant uniquement rapide est utilisé.

fmExactRecsMax

Similaire au mode fmAll, mais si la quantité d'enregistrements extraits diffère de celle spécifiée dans RecsMax, une exception est déclenchée.

La valeur par défaut est fmOnDemand, pour TFDCustomMemTable la valeur est fmAll.

Voir aussi