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 che il provider deve recuperare contemporaneamente nella memoria locale. Ad esempio, se CacheSize è 10, dopo aver aperto prima 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 ci si sposta 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 (nella raccolta Properties dell'oggetto Recordset). Non è possibile impostare CacheSize su un valore maggiore di Numero massimo righe aperte. Per modificare il numero di righe che possono essere aperte dal provider, impostare Numero massimo 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 recuperi dall'origine dati. La sola modifica del valore della proprietà non modifica 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.

L'impostazione di CacheSize su 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 1, i metodi di spostamento (Move, MoveFirst, MoveLast, MoveNext e MovePrevious) possono comportare lo spostamento 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 finché non si tenta di accedere a un valore di dati da una riga eliminata. Tuttavia, l'impostazione di CacheSize su 1 elimina questo problema perché le righe eliminate non possono essere recuperate.

Si applica a

Oggetto Recordset (ADO)

Vedere anche

Esempio della proprietà CacheSize (VB)
Esempio della proprietà CacheSize (VC++)
Esempio della proprietà CacheSize (JScript)