CacheSize-Eigenschaft (ADO)

Gilt für: Access 2013, Office 2013

Gibt die Anzahl von Datensätzen aus einem Recordset-Objekt an, die lokal im Arbeitsspeicher zwischengespeichert werden.

Einstellungen und Rückgabewerte

Sets or returns a Long value that must be greater than 0. Der Standardwert ist 1.

Hinweise

Verwenden Sie die CacheSize-Eigenschaft, um zu steuern, wie viele Datensätze gleichzeitig vom Anbieter in den lokalen Arbeitsspeicher abgerufen werden. Wenn z. B. CacheSize den Wert 10 hat, ruft der Anbieter, nachdem er zunächst das Recordset-Objekt geöffnet hat, die ersten 10 Datensätze in den lokalen Arbeitsspeicher ab. Beim Durchlaufen des Recordset-Objekts gibt der Anbieter die Daten aus dem lokalen Arbeitsspeicherpuffer zurück. Sobald Sie hinter den letzten Datensatz im Cache gelangt sind, ruft der Anbieter die nächsten 10 Datensätze von der Datenquelle in den Cache ab.

Hinweis

[!HINWEIS] CacheSize basiert auf der anbieterspezifischen Eigenschaft Maximale Anzahl geöffneter Zeilen (in der Properties -Auflistung des Recordset -Objekts). CacheSize kann nicht auf einen höheren Wert als Maximale Anzahl geöffneter Zeilen festgelegt werden. Legen Sie Maximale Anzahl geöffneter Zeilen fest, um die Anzahl von Zeilen zu ändern, die vom Anbieter geöffnet werden können.

Der Wert von CacheSize kann während des Lebenszyklus des Recordset -Objekts angepasst werden, aber die Änderung dieses Werts wirkt sich nur auf die Anzahl von Datensätzen im Cache nach nachfolgendem Abrufen von der Datenquelle aus. Durch das Ändern des Eigenschaftswerts allein werden die aktuellen Inhalte des Caches nicht geändert.

Wenn weniger Datensätze abzurufen sind, als durch CacheSize angegeben sind, gibt der Anbieter die restlichen Datensätze zurück, und es tritt kein Fehler auf.

A CacheSize setting of zero is not allowed and returns an error.

Aus dem Cache abgerufene Datensätze enthalten keine Änderungen, die andere Benutzer gleichzeitig an den Quelldaten vorgenommen haben. Verwenden Sie die Resync-Methode, um eine Aktualisierung aller zwischengespeicherter Daten zu erzwingen.

Wenn CacheSize auf einen Wert größer als 1 festgelegt ist, können die Navigationsmethoden (Move, MoveFirst, MoveLast, MoveNext und MovePrevious) zur Navigation zu einem gelöschten Datensatz führen, wenn der Löschvorgang nach dem Abrufen der Datensätze erfolgt. After the initial fetch, subsequent deletions will not be reflected in your data cache until you attempt to access a data value from a deleted row. However, setting CacheSize to one eliminates this issue since deleted rows cannot be fetched.