Partager via

CacheSize, propriété (ADO)

  • Article

S’applique à : Access 2013, Office 2013

Indique le nombre d'enregistrements dans un objet Recordset, placés dans la mémoire cache locale.

Paramètres et valeurs de retour

Définit ou renvoie une valeur de type Long qui doit être supérieure à 0. La valeur par défaut est 1.

Remarques

Utilisez la propriété CacheSize pour contrôler le nombre d'enregistrements à récupérer simultanément à partir du fournisseur pour les insérer dans la mémoire locale. Par exemple, si CacheSize a pour valeur 10, après la première ouverture de l'objet Recordset, le fournisseur extrait les dix premiers enregistrements pour les insérer dans la mémoire locale. À mesure que vous parcourez l'objet Recordset, le fournisseur retourne les données du tampon de mémoire local. Dès que vous avez dépassé le dernier enregistrement du cache, le fournisseur récupère les dix enregistrements suivants de la source de données pour les insérer dans le cache.

Remarque

[!REMARQUE] CacheSize dépend de la propriété Maximum Open Rows spécifique au fournisseur (dans la collection Properties de l'objet Recordset ). Vous ne pouvez pas affecter à CacheSize une valeur supérieure à celle de la propriété Maximum Open Rows. Pour modifier le nombre de lignes que le fournisseur peut ouvrir, définissez Maximum Open Rows.

La valeur de CacheSize peut être ajustée au cours de la durée de vie de l'objet Recordset, mais si vous modifiez cette valeur, cela n'affecte que le nombre d'enregistrements présents en mémoire cache après plusieurs extractions successives de la source de données. La modification de la seule valeur de la propriété ne suffira pas à modifier le contenu actuel du cache.

Si le nombre d'enregistrements à récupérer est inférieur à la valeur de CacheSize spécifiée, le fournisseur retourne les enregistrements restants sans qu'aucune erreur ne se produise.

Vous ne pouvez pas utiliser un paramètre CacheSize de valeur zéro. Dans ce cas, une erreur est générée.

Les enregistrements extraits du cache ne reflètent pas les modifications simultanées apportées aux données sources par d'autres utilisateurs. Pour forcer la mise à jour de toutes les données mises en cache, utilisez la méthode Resync.

Si CacheSize a une valeur supérieure à 1, les méthodes de navigation (Move, MoveFirst, MoveLast, MoveNext et MovePrevious) peuvent parfois accéder à un enregistrement supprimé, si une suppression a lieu après l’extraction des enregistrements. Après l’extraction initiale, les suppressions suivantes ne sont pas reflétées dans le cache de données tant que vous ne tentez pas d’accéder à une valeur de donnée d’une ligne supprimée. Cependant, si vous attribuez la valeur 1 à CacheSize, le problème ne se pose pas puisque les lignes supprimées ne peuvent pas être extraites.