Partager via


classe de CBulkRowset

Récupère et manipule les lignes pour travailler sur des données en bloc en récupérant plusieurs descripteurs de ligne avec un appel unique.

template <class TAccessor>
class CBulkRowset : public CRowset<TAccessor>

Paramètres

  • TAccessor
    Un classe accesseur.

Membres

Méthodes

AddRefRows

Incrémente le nombre de références.

CBulkRowset

Constructeur.

MoveFirst

Récupère la première ligne de données, en effectuant un nouvelle extraction de bloc si nécessaire.

MoveLast

Passe à la dernière ligne.

MoveNext

Extrait la ligne suivante de données.

MovePrev

Passe à la ligne précédente.

MoveToBookmark

Extrait la ligne marquée par un signet ou la ligne à un nombre de lignes spécifié de ce signet.

MoveToRatio

Extrait des lignes en commençant à une position décimale dans l'ensemble de lignes.

ReleaseRows

Mets la ligne actuelle (m_nCurrentRow) à zéro et libère toutes les lignes.

SetRows

Définit le nombre de descripteurs de lignes à extraire avec un appel.

Exemple

L'exemple suivant illustre l'utilisation de la classe CBulkRowset.

class CCustomerData
{
public:
   char m_szField1[50];

   BEGIN_COLUMN_MAP(CCustomerData)
     COLUMN_ENTRY(1, m_szField1)
   END_COLUMN_MAP()
};

void DoCBulkRowsetTest()
{
   CoInitialize(NULL);

   CCommand<CAccessor<CCustomerData>, CBulkRowset > cmd;
   CDataSource ds;

   // Open up data link dialogs to create a data source
   ds.Open();

   CSession session;
   session.Open(ds);
   // Could call SetRows() here if you want to fetch  
   // more than 10 HROWs at a time.
   cmd.Open(session, L"Select * from customer");
   cmd.MoveFirst();
   // Note that the CBulkRowset by default fetched 10 HROWs at a time  
   // so that the MoveNext call will not have to make the GetNextRows  
   // call to get the second HROW because it has already been fetched  
   //by the MoveFirst() call above.
   cmd.MoveNext();

   cmd.Close();
   session.Close();
   ds.Close();
}

Configuration requise

En-tête : : atldbcli.h

Voir aussi

Concepts

Modèles du consommateur OLE DB (C++)

Référence des modèles du consommateur OLE DB