CRecordset::GetRowsFetched

Artikel
02/26/2013

Bestimmt, wie viele Datensätze tatsächlich nach einem Abruf abgerufen wurden.

DWORD GetRowsFetched( ) const;

Rückgabewert

Die Anzahl der Zeilen abgerufen aus der Datenquelle nach einem angegebenen Abruf.

Hinweise

Dies ist hilfreich, wenn Sie das gesammelte Abrufen von Zeilen implementiert haben.Die Größe des Rowsets gibt normalerweise an, wie viele Zeilen aus einem Abruf abgerufen werden; es wirkt sich die Gesamtzahl der Zeilen im Recordset auch, wie viele Zeilen in einem Rowset abgerufen werden.Wenn das Recordset 10 Datensätze mit einer Rowsetgrößeneinstellung von 4 aufweist, dann führt die Schleife durch das Recordset, indem sie MoveNext aufruft, das endgültige Rowset, das nur 2 Datensätze verfügt.

Um das gesammelte Abrufen von Zeilen zu implementieren, müssen Sie die CRecordset::useMultiRowFetch Option im dwOptions-Parameter der Memberfunktion Geöffnet angeben.Um die Größe des Rowsets anzugeben, rufen Sie SetRowsetSize auf.

Weitere Informationen über das gesammelte Abrufen von Zeilen, finden Sie im Artikel Recordset: Datensätzen in einer Sammeloperation (ODBC).

Beispiel

CMultiCustomer rs(&m_dbCust);

// Set the rowset size
rs.SetRowsetSize(5);

// Open the recordset
rs.Open(CRecordset::dynaset, NULL, CRecordset::useMultiRowFetch);

// loop through the recordset by rowsets
while(!rs.IsEOF())
{
   for(int rowCount = 0; rowCount < (int)rs.GetRowsFetched(); rowCount++)
   {
      // do something
   }

   rs.MoveNext();
}

rs.Close();