IRowsetLocateImpl, classe

Article
03/04/2013

Implémente l'interface OLE DB IRowsetLocate , qui récupère les lignes arbitraires de jeu de lignes.

template <
   class T, 
   class RowsetInterface, 
   class RowClass = CSimpleRow, 
   class MapClass = CAtlMap < RowClass::KeyType, RowClass* >, 
   class BookmarkKeyType = LONG, 
   class BookmarkType = LONG, 
   class BookmarkMapClass = CAtlMap < RowClass::KeyType, RowClass* >
>
class ATL_NO_VTABLE IRowsetLocateImpl : public IRowsetImpl<
   T, 
   RowsetInterface, 
   RowClass, 
   MapClass
>

Paramètres

T
Une classe dérivée d' IRowsetLocateImpl.
RowsetInterface
Une classe dérivée d' IRowsetImpl.
RowClass
l'unité de stockage pour HROW.
MapClass
L'unité de stockage pour toutes les handles de ligne conservées par le fournisseur.
BookmarkKeyType
Le type du signet, tel qu'un LONG ou une chaîne.Les signets ordinaires doivent avoir une longueur d'au moins deux octets.(La longueur codée sur un octet est réservée pour OLE DB signets standardDBBMK_FIRST, DBBMK_LAST, et DBBMK_INVALID.)
BookmarkType
Le mécanisme de mappage pour effectuer le suivi des relations de signet-à-données.
BookmarkMapClass
L'unité de stockage pour toutes les handles de ligne conservées par le signet.

Membres

Méthodes d'interface

Comparez	Compare deux signets.
GetRowsAt	Extrait les lignes commençant par la ligne spécifiée par un offset à un signet.
GetRowsByBookmark	Récupère les lignes qui correspondent aux signets spécifiés.
Hachage	Retourne des valeurs de hachage pour les signets spécifiés.

Données membres

m_rgBookmarks

Un tableau de signets.

Notes

IRowsetLocateImpl est l'implémentation des modèles OLE DB de l'interface d' IRowsetLocate .IRowsetLocate est utilisé pour récupérer les lignes arbitraires de jeu de lignes.Un ensemble de lignes qui n'implémente pas cette interface est un ensemble de lignes d' sequential .Lorsque IRowsetLocate est présent sur un jeu de lignes, colonne 0 est le signet pour les lignes ; lire cette colonne a une valeur du signet qui peut être utilisée pour repositionner à la même ligne.

IRowsetLocateImpl est utilisé pour implémenter la prise en charge de signets dans les fournisseurs.Les signets sont des espaces réservés (index sur un jeu de lignes) qui permettent au consommateur pour retourner rapidement à une ligne, qui autorise l'accès rapide aux données.Le fournisseur détermine les signets peuvent uniquement identifier une ligne.L'utilisation de méthodes d' IRowsetLocateImpl , vous pouvez comparer les signets, récupérer des lignes par l'offset, récupérer des lignes par le signet, puis retourner des valeurs de hachage pour les signets.

Pour prendre en charge des signets OLE DB dans un jeu de lignes, faites le jeu de lignes hériter de cette classe.

Pour plus d'informations sur l'implémentation de la prise en charge de signets, consultez Prise en charge de fournisseur des signets dans Le guide du programmeur Visual C++ et le signets dans OLE DB Programmer's Reference dans PlatformSDK.