Propriedade CacheSize (ADO)
Aplica-se ao: Access 2013, Office 2013
Indica o número de registros de um objeto Recordset que ficam armazenados em cache localmente na memória.
Configurações e valores retornados
Define ou retorna um valor Long que deve ser maior do que 0. O padrão é 1.
Comentários
Use a propriedade CacheSize para controlar a quantidade de registros a serem recuperados de uma vez, do provedor para a memória local. Por exemplo, se CacheSize for 10, após a abertura inicial do objeto Recordset, o provedor irá recuperar os 10 primeiros registros para a memória local. À medida que você se movimentar pelo objeto Recordset, o provedor retornará os dados do buffer de memória local. Assim que você passar pelo último registro armazenado em cache, o provedor irá recuperar os 10 registros seguintes da fonte de dados para o cache.
Observação
[!OBSERVAçãO] A propriedade CacheSize baseia-se na propriedade Maximum Open Rows específica do provedor (na coleção Properties do objeto Recordset ). Não é possível definir CacheSize para um valor maior do que Maximum Open Rows. Para modificar o número de linhas que podem ser abertas pelo provedor, defina Maximum Open Rows.
O valor de CacheSize pode ser ajustado enquanto o objeto Recordset durar, mas a alteração desse valor afetará apenas o número de registros no cache após recuperações subsequentes da fonte de dados. Alterar apenas o valor da propriedade não irá alterar o conteúdo atual do cache.
Se o número de registros a serem recuperados for menor do que o especificado em CacheSize, o provedor retornará os registros restantes e não ocorrerá erros.
Não é permitido definir CacheSize como zero e isso provocará um erro.
Os registros recuperados do cache não refletem alterações simultâneas feitas por outros usuários na fonte de dados. Para forçar uma atualização de todos os dados armazenados em cache, use o método Resync.
Se CacheSize for definida com um valor maior do que um, os métodos de navegação (Move, MoveFirst, MoveLast, MoveNext e MovePrevious) poderão resultar na navegação para um registro excluído, caso a exclusão ocorra depois que os registros forem recuperados. Após a busca inicial, as exclusões seguintes não serão refletidas no cache de dados até que você tente acessar um valor de dados de uma linha excluída. Contudo, a definição de CacheSize como um elimina esse problema, uma vez que as linhas excluídas não poderão ser encontradas.