CacheSize-Eigenschaft (ADO)

Gibt die Anzahl an Datensätzen eines Recordset-Objekts an, die im lokalen Speicher zwischengespeichert sind

Einstellungen und Rückgabewerte

Legt einen Long-Wert fest, der größer als 0 sein muss, oder gibt ihn zurück. Der Standardwert ist 1.

Bemerkungen

Verwenden Sie die CacheSize-Eigenschaft, um zu steuern, wie viele Datensätze vom Anbieter gleichzeitig in den lokalen Speicher abgerufen werden sollen. Wenn CacheSize beispielsweise 10 ist, ruft der Anbieter nach dem ersten Öffnen des Recordset-Objekts die ersten 10 Datensätze in den lokalen Speicher ab. Während Sie das Recordset-Objekt durchlaufen, gibt der Anbieter die Daten aus dem lokalen Speicherpuffer zurück. Sobald Sie den letzten Datensatz im Cache durchlaufen haben, ruft der Anbieter die nächsten 10 Datensätze aus der Datenquelle in den Cache ab.

Hinweis

CacheSize basiert auf der anbieterspezifischen Maximum Open Rows-Eigenschaft in der Properties-Sammlung des Recordset-Objekts. CacheSize kann nicht auf einen Wert festgelegt werden, der größer als Maximum Open Rows ist. Um die Anzahl der Zeilen zu ändern, die vom Anbieter geöffnet werden können, legen Sie Maximum Open Rows fest.

Der Wert von CacheSize kann während der Lebensdauer des Recordset-Objekts angepasst werden. Das Ändern dieses Werts wirkt sich allerdings nur auf die Anzahl der Datensätze im Cache nach nachfolgendem Abrufen aus der Datenquelle aus. Das Ändern des Eigenschaftswerts allein ändert den aktuellen Inhalt des Cache nicht.

Wenn weniger Datensätze abgerufen werden sollen als CacheSize angibt, gibt der Anbieter die verbliebenen 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.

Datensätze, die aus dem Cache abgerufen wurden, spiegeln keine gleichzeitigen Änderungen wider, die andere Benutzer*innen an den Quelldaten vorgenommen haben. Verwenden Sie die Resync-Methode, um eine Aktualisierung aller zwischengespeicherten Daten zu erzwingen.

Wenn CacheSize auf einen Wert größer als 1 festgelegt ist, können die Navigationsmethoden – Move, MoveFirst, MoveLast, MoveNext und MovePrevious – zu einem gelöschten Datensatz führen, wenn der Löschvorgang erfolgt, nachdem die Datensätze abgerufen wurden. Nach dem anfänglichen Abrufen werden nachfolgende Löschungen erst in Ihrem Datencache angezeigt, wenn Sie versuchen, von einer gelöschten Zeile aus auf einen Datenwert zuzugreifen. Das Festlegen von CacheSize auf 1 beseitigt dieses Problem jedoch, da gelöschte Zeilen nicht abgerufen werden können.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

CacheSize-Eigenschaft – Beispiel (VB)
CacheSize-Eigenschaft – Beispiel (VC++)
CacheSize-Eigenschaft – Beispiel (JScript)