Propriedade CacheSize (ADO)

Indica o número de registros de um recordset objeto que são armazenados em cache localmente na memória.

Configurações e valores retornados

Define ou retorna um valor long que deve ser maior que 0. O padrão é 1.

Observações

Use a propriedade CacheSize para controlar quantos registros recuperar ao mesmo tempo na memória local do provedor. Por exemplo, se o CacheSize for 10, depois de abrir primeiro o objeto Recordset, o provedor recuperará os primeiros 10 registros na memória local. À medida que você passa pelo objeto Recordset, o provedor retorna os dados do buffer de memória local. Assim que você passar do último registro no cache, o provedor recuperará os próximos 10 registros da fonte de dados para o cache.

Nota

cacheSize baseia-se na propriedade Máximo de Linhas Abertas específica do provedor (na coleção Properties do objeto Recordset). Não é possível definir cacheSize para um valor maior que máximo de linhas abertas. Para modificar o número de linhas que podem ser abertas pelo provedor, defina Máximo de Linhas Abertas.

O valor de cacheSize pode ser ajustado durante a vida útil do objeto Recordset, mas alterar esse valor afeta apenas o número de registros no cache após as recuperações subsequentes da fonte de dados. Alterar o valor da propriedade sozinho não alterará o conteúdo atual do cache.

Se houver menos registros a serem recuperados do que o CacheSize especificar, o provedor retornará os registros restantes e nenhum erro ocorrerá.

Uma configuração de CacheSize de zero não é permitida e retorna um erro.

Os registros recuperados do cache não refletem alterações simultâneas feitas por outros usuários nos dados de origem. Para forçar uma atualização de todos os dados armazenados em cache, use o método Resync.

Se CacheSize for definido como um valor maior 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, se a exclusão ocorrer após a recuperação dos registros. Após a busca inicial, as exclusões subsequentes não serão refletidas no cache de dados até que você tente acessar um valor de dados de uma linha excluída. No entanto, a configuração CacheSize para um elimina esse problema, pois as linhas excluídas não podem ser buscadas.

Aplica-se a

do objeto Recordset (ADO)

Consulte Também

exemplo da propriedade CacheSize (VB)
exemplo da propriedade CacheSize (VC++)
Exemplo da propriedade CacheSize (JScript)