Properti CacheSize (ADO)

  • Artikel

Menunjukkan jumlah rekaman dari objek Recordset yang di-cache secara lokal dalam memori.

Pengaturan dan Nilai Pengembalian

Mengatur atau mengembalikan nilai Panjang yang harus lebih besar dari 0. Defaultnya adalah 1.

Keterangan

Gunakan properti CacheSize untuk mengontrol berapa banyak rekaman yang akan diambil pada satu waktu ke memori lokal dari penyedia. Misalnya, jika CacheSize adalah 10, setelah pertama kali membuka objek Recordset , penyedia mengambil 10 rekaman pertama ke memori lokal. Saat Anda menelusuri objek Recordset , penyedia mengembalikan data dari buffer memori lokal. Segera setelah Anda bergerak melewati rekaman terakhir di cache, penyedia mengambil 10 rekaman berikutnya dari sumber data ke dalam cache.

Catatan

CacheSize didasarkan pada properti spesifik penyedia Baris Terbuka Maksimum (dalam kumpulan Properti objek Recordset ). Anda tidak dapat mengatur CacheSize ke nilai yang lebih besar dari Maksimum Baris Terbuka. Untuk mengubah jumlah baris yang dapat dibuka oleh penyedia, atur Baris Buka Maksimum.

Nilai CacheSize dapat disesuaikan selama masa pakai objek Recordset , tetapi mengubah nilai ini hanya memengaruhi jumlah rekaman dalam cache setelah pengambilan berikutnya dari sumber data. Mengubah nilai properti saja tidak akan mengubah konten cache saat ini.

Jika ada lebih sedikit rekaman yang harus diambil daripada yang ditentukan CacheSize , penyedia mengembalikan rekaman yang tersisa dan tidak ada kesalahan yang terjadi.

Pengaturan CacheSize nol tidak diizinkan dan mengembalikan kesalahan.

Rekaman yang diambil dari cache tidak mencerminkan perubahan bersamaan yang dilakukan pengguna lain pada data sumber. Untuk memaksa pembaruan semua data yang di-cache, gunakan metode Resync .

Jika CacheSize diatur ke nilai yang lebih besar dari satu, metode navigasi (Move, MoveFirst, MoveLast, MoveNext, dan MovePrevious) dapat mengakibatkan navigasi ke rekaman yang dihapus, jika penghapusan terjadi setelah rekaman diambil. Setelah pengambilan awal, penghapusan berikutnya tidak akan tercermin dalam cache data Anda sampai Anda mencoba mengakses nilai data dari baris yang dihapus. Namun, mengatur CacheSize ke salah satu menghilangkan masalah ini karena baris yang dihapus tidak dapat diambil.

Berlaku Untuk

Objek Recordset (ADO)

Lihat juga

Contoh properti CacheSize (Visual Basic)
Contoh properti CacheSize (VC++)
Contoh Properti CacheSize (Jscript)