Data.Win.ADODB.TCustomADODataSet.CacheSize

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property CacheSize: Integer read GetCacheSize write SetCacheSize default 1;

C++

__property int CacheSize = {read=GetCacheSize, write=SetCacheSize, default=1};

Propriétés

Type Visibilité  Source Unité  Parent
property published
Data.Win.ADODB.pas
Data.Win.ADODB.hpp
Data.Win.ADODB TCustomADODataSet

Description

Spécifie la taille du cache de l'ensemble de données.

Initialisez CacheSize pour contrôler le nombre de lignes que le fournisseur de l'ensemble de données ADO conserve en mémoire cache dans son tampon et le nombre qu'il récupère en une seule fois dans la mémoire locale. La valeur par défaut de CacheSize est 1 et la valeur minimum autorisée est 1.

Si, par exemple, CacheSize a la valeur 20, à la première activation de l'ensemble de données le fournisseur associé récupère les 20 premières lignes dans la mémoire locale. Quand le pointeur de ligne se déplace dans l'ensemble d'enregistrements, le fournisseur récupère les données dans le tampon en mémoire locale. Si le pointeur de ligne de l'ensemble de données sort de ces 20 lignes du tampon, le fournisseur récupère les 20 suivantes.

CacheSize représente le nombre maximum de lignes à récupérer à un moment donné. Si le nombre de lignes restant à récupérer est inférieur à CacheSize, les lignes restantes sont récupérées sans déclencher d'exception. Le nombre de lignes pouvant être renvoyées par le fournisseur peut être inférieur à toutes les lignes si la propriété MaxRecords du composant ensemble de données ADO est définie à une valeur différente de la valeur par défaut (toutes les lignes).

Remarque :  Les lignes récupérées du cache ne reflètent pas les modifications effectuées par d'autres utilisateurs simultanés des données.

Voir aussi