Freigeben über


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.

HinweisHinweis

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.

HinweisHinweis

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

Siehe auch

Referenz

CRecordset-Klasse

Hierarchien-Diagramm

CRecordset::Open

CRecordset::GetRowsetSize

CRecordset::CheckRowsetError

CRecordset::DoBulkFieldExchange