CRecordset::SetRowsetSize
Gibt die Anzahl der Datensätze an, die Sie während eines Abrufs abrufen möchten.
virtual void SetRowsetSize(
DWORD dwNewRowsetSize
);
Parameter
- dwNewRowsetSize
Die Anzahl der während eines angegebenen Abrufs abzurufenden Zeilen.
Hinweise
Diese virtuelle Memberfunktion gibt an, wie viele Zeilen Sie während einer einzigen Abfrage abrufen möchten, wenn Sie das gesammelte Abrufen von Zeilen verwenden. Um das gesammelte Abrufen von Zeilen zu implementieren, müssen Sie die CRecordset::useMultiRowFetch Option im dwOptions-Parameter der Memberfunktion Geöffnet festlegen.
Hinweis
Das Aufrufen von SetRowsetSize, ohne das gesammelte Abrufen von Zeilen implementiert wird, führt zu einem Assertionsfehler.
Rufen Sie SetRowsetSize auf, bevor Sie Öffnen aufrufen, um die Größe des Rowsets für das Recordset zuerst festzulegen. Die Standardgröße des Rowsets, wenn sie das gesammelte Abrufen von Zeilen implementiert, ist 25.
Hinweis
Verwendungsvorsicht, wenn SetRowsetSize aufgerufen wird.Wenn Sie manuell Speicher für die Daten (wie durch die CRecordset::userAllocMultiRowBuffers Option des dwOptions Parameters in Öffnen angegeben) zuordnen, sollten Sie überprüfen, ob diese Speicherpuffer zuteilen müssen, nachdem Sie SetRowsetSize aufrufen, aber bevor Sie jeden Cursor-Navigationsvorgang ausführen.
Sie können die aktuelle Einstellung für die Größe des Rowsets, rufen Sie GetRowsetSize auf.
Weitere Informationen über das gesammelte Abrufen von Zeilen, finden Sie im Artikel Recordset: Datensätzen in einer Sammeloperation (ODBC).
Anforderungen
Header: afxdb.h