Proprietà CacheSize (ADO)
Indica il numero di record di un oggetto Recordset memorizzati nella cache in locale in memoria.
Impostazioni e valori restituiti
Imposta o restituisce un valore long che deve essere maggiore di 0. Il valore predefinito è 1.
Osservazioni
Utilizzare la proprietà CacheSize per controllare il numero di record da recuperare contemporaneamente nella memoria locale dal provider. Ad esempio, se il cacheSize è 10, dopo aver aperto l'oggetto recordset , il provider recupera i primi 10 record nella memoria locale. Durante lo spostamento nell'oggetto recordset , il provider restituisce i dati dal buffer di memoria locale. Non appena si passa oltre l'ultimo record nella cache, il provider recupera i 10 record successivi dall'origine dati nella cache.
Nota
CacheSize si basa sulla proprietà specifica del provider maximum open rows (nell'insieme Properties dell'oggetto recordset). Non è possibile impostare CacheSize su un valore maggiore di numero massimo di righe aperte. Per modificare il numero di righe che possono essere aperte dal provider, impostare Numero massimo di righe aperte.
Il valore di CacheSize può essere modificato durante la durata dell'oggetto recordset , ma la modifica di questo valore influisce solo sul numero di record nella cache dopo i successivi recupero dall'origine dati. La modifica del valore della proprietà da sola non modificherà il contenuto corrente della cache.
Se sono presenti meno record da recuperare rispetto a CacheSize, il provider restituisce i record rimanenti e non si verifica alcun errore.
Un'impostazione cacheSize pari a zero non è consentita e restituisce un errore.
I record recuperati dalla cache non riflettono le modifiche simultanee apportate da altri utenti ai dati di origine. Per forzare un aggiornamento di tutti i dati memorizzati nella cache, usare il metodo Resync.
Se CacheSize è impostato su un valore maggiore di uno, i metodi di spostamento (Move, MoveFirst, MoveLast, MoveNext e MovePrevious) possono comportare la navigazione in un record eliminato, se l'eliminazione si verifica dopo il recupero dei record. Dopo il recupero iniziale, le eliminazioni successive non verranno riflesse nella cache dei dati fino a quando non si tenta di accedere a un valore di dati da una riga eliminata. Tuttavia, l'impostazione di cacheSize su uno elimina questo problema perché non è possibile recuperare le righe eliminate.
Si applica a
Vedere anche
Esempio di proprietà CacheSize (VB)
Esempio di proprietà CacheSize (VC++)
Esempio di proprietà CacheSize (JScript)