Partager via


CRecordset::SetRowsetSize

Spécifie le nombre d'enregistrements que vous souhaitez récupérer pendant un effort.

virtual void SetRowsetSize(
   DWORD dwNewRowsetSize 
);

Paramètres

  • dwNewRowsetSize
    Le nombre de lignes à partir d'une contrainte donné.

Notes

Cette fonction membre virtuelle spécifie le nombre de lignes vous souhaitez récupérer lors d'une seule extraction lors de l'extraction de lignes en bloc.Pour implémenter l'extraction de lignes en bloc, vous devez définir l'option d' CRecordset::useMultiRowFetch dans le paramètre d' dwOptions de la fonction membre d' Ouvrez .

[!REMARQUE]

Appeler SetRowsetSize sans implémenter l'extraction de lignes en bloc provoquera une assertion.

Appelez SetRowsetSize avant que l'appel Ouvrir pour définir initialement la taille du jeu de lignes du recordset.La taille du jeu de lignes par défaut en implémentant l'extraction de lignes en bloc est 25.

[!REMARQUE]

Être prudent en appelant SetRowsetSize.Si vous allouez manuellement la mémoire pour les données (comme spécifié par l'option de CRecordset::userAllocMultiRowBuffers du paramètre de dwOptions dans Ouvrir), vous devez vérifier si vous devez réaffecter ces tampons de stockage après avoir appelé SetRowsetSize, mais avant d'exécuter toute opération de navigation du curseur.

Pour obtenir la configuration actuelle de la taille du jeu de lignes, appelez GetRowsetSize.

Pour plus d'informations sur l'extraction de lignes en bloc, consultez l'article recordset : Extraction globale d'enregistrements (ODBC).

Configuration requise

Header: afxdb.h

Voir aussi

Référence

Classe de CRecordset

Graphique de la hiérarchie

CRecordset::Open

CRecordset::GetRowsetSize

CRecordset::CheckRowsetError

CRecordset::DoBulkFieldExchange