CacheSize-Eigenschaft (ADO)
Gibt die Anzahl der Datensätze aus einem Recordset-objekt an, die lokal im Arbeitsspeicher zwischengespeichert werden.
Einstellungen und Rückgabewerte
Dient zum Festlegen oder Zurückgeben eines Long Werts, der größer als 0 sein muss. Der Standardwert ist 1.
Bemerkungen
Verwenden Sie die CacheSize Eigenschaft, um zu steuern, wie viele Datensätze gleichzeitig in den lokalen Speicher des Anbieters abgerufen werden sollen. Wenn die CacheSize- beispielsweise 10 ist, ruft der Anbieter nach dem ersten Öffnen des Recordset-Objekts die ersten 10 Datensätze im lokalen Speicher ab. Während Sie durch das Recordset-Objekt navigieren, gibt der Anbieter die Daten aus dem lokalen Speicherpuffer zurück. Sobald Sie den letzten Datensatz im Cache übergehen, ruft der Anbieter die nächsten 10 Datensätze aus der Datenquelle im Cache ab.
Anmerkung
CacheSize basiert auf der Maximum Open Rows anbieterspezifische Eigenschaft (in der Properties Auflistung des Recordset-Objekts). Sie können CacheSize- nicht auf einen Wert festlegen, der größer als maximale geöffnete Zeilenist. Um die Anzahl der Zeilen zu ändern, die vom Anbieter geöffnet werden können, legen Sie maximale geöffnete Zeilenfest.
Der Wert von CacheSize- kann während der Lebensdauer des Recordset-Objekts angepasst werden, aber das Ändern dieses Werts wirkt sich nur auf die Anzahl der Datensätze im Cache nach nachfolgenden Abrufen aus der Datenquelle aus. Das Ändern des Eigenschaftswerts allein ändert nicht den aktuellen Inhalt des Caches.
Wenn weniger Datensätze abgerufen werden müssen als CacheSize- angibt, gibt der Anbieter die verbleibenden Datensätze zurück, und es tritt kein Fehler auf.
Eine CacheSize Einstellung von Null ist nicht zulässig und gibt einen Fehler zurück.
Aus dem Cache abgerufene Datensätze spiegeln keine gleichzeitigen Änderungen wider, die andere Benutzer an den Quelldaten vorgenommen haben. Um eine Aktualisierung aller zwischengespeicherten Daten zu erzwingen, verwenden Sie die Resync-Methode.
Wenn CacheSize- auf einen Wert festgelegt ist, der größer als ein Wert ist, können die Navigationsmethoden (Move, MoveFirst, MoveLast, MoveNext und MovePrevious) zu einer Navigation zu einem gelöschten Datensatz führen, wenn das Löschen nach dem Abrufen der Datensätze erfolgt. Nach dem anfänglichen Abruf werden nachfolgende Löschungen erst in Ihrem Datencache widerzuspiegeln, wenn Sie versuchen, auf einen Datenwert aus einer gelöschten Zeile zuzugreifen. Das Festlegen CacheSize- auf eins beseitigt dieses Problem, da gelöschte Zeilen nicht abgerufen werden können.
Gilt für
Siehe auch
CacheSize-Eigenschaft (Vb-Beispiel)
CacheSize-Eigenschaft (VC++-Beispiel)
CacheSize-Eigenschaft (Beispiel) (JScript)