Compartilhar via


CRecordset::GetRowsFetched

Determina quantos registros foram recuperados realmente após um esforço.

DWORD GetRowsFetched( ) const;

Valor de retorno

O número de linhas recuperadas da fonte de dados após um esforço dado.

Comentários

Isso é útil quando você tiver implementado buscar em massa da linha. O tamanho de rowset indica normalmente quantas linhas serão recuperadas de um esforço; no entanto, o número total de linhas no conjunto de registros também afeta quantas linhas serão recuperadas em um rowset. Por exemplo, se seu conjunto de registros é 10 registros com uma configuração de tamanho de rowset de 4, então repetindo com o conjunto de registros chamando MoveNext resultará ao final rowset que tem apenas 2 registros.

Para implementar a linha em massa que pesquisa, você deve especificar a opção de CRecordset::useMultiRowFetch no parâmetro de dwOptions da função de membro de Abrir . Para especificar o tamanho de rowset, chame SetRowsetSize.

Para obter mais informações sobre a linha em massa que pesquisa, consulte o artigo conjunto de registros: Para buscar registros em massa (ODBC).

Exemplo

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();

Requisitos

Cabeçalho: afxdb.h

Consulte também

Referência

Classe CRecordset

Gráfico da hierarquia

CRecordset::SetRowsetSize

CRecordset::CheckRowsetError