Propriedade CacheSize (ADO)

Indica o número de registros de um objeto Recordset armazenados em cache localmente na memória.

Configurações e valores retornados

Define ou retorna um valor Long que precisa ser maior que 0. O padrão é UTF-1.

Comentários

Use a propriedade CacheSize para controlar quantos registros serão recuperados 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 vai recuperar os primeiros dez 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ê passa o último registro no cache, o provedor recupera os próximos dez registros da fonte de dados no cache.

Observação

O CacheSize baseia-se na propriedade específica do provedor Maximum Open Rows (na coleção Properties do objeto Recordset). Não é possível definir CacheSize como um valor maior que o 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 durante a vida útil do objeto Recordset, mas a alteração desse valor afeta apenas o número de registros no cache após as recuperações posteriores da fonte de dados. A alteração do valor da propriedade por si só não vai alterar o conteúdo atual do cache.

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

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

Os registros recuperados do cache não refletem as 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 1, 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 posteriores 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 definição de CacheSize como 1 elimina esse problema porque as linhas excluídas não podem ser buscadas.

Aplica-se A

Objeto Recordset (ADO)

Consulte Também

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