Classe IRowsetLocateImpl

Articolo
06/10/2015

Implementa l'interfaccia OLE DB L'interfaccia IRowsetLocate, che recupera le righe arbitrarie di un rowset.

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 
>

Parametri

T
Classe derivata da IRowsetLocateImpl.
RowsetInterface
Classe derivata da IRowsetImpl.
RowClass
L'unità di archiviazione per HROW.
MapClass
L'unità di archiviazione per tutti gli handle di riga utilizzate dal provider.
BookmarkKeyType
Il tipo del segnalibro, ad esempio un LONG o una stringa. I segnalibri comuni devono avere una lunghezza almeno due byte. (La lunghezza a byte singolo è riservata per OLE DB segnalibri standardDBBMK_FIRST, DBBMK_LAST e DBBMK_INVALID).
BookmarkType
Il meccanismo di mapping per gestire le relazioni di segnalibro a dati.
BookmarkMapClass
L'unità di archiviazione per tutti gli handle di riga utilizzate dal segnalibro.

Membri

Metodi di interfaccia

Confronto	Confronta due segnalibri.
GetRowsAt	Le raccolte da iniziare con la riga specificata da un offset da un segnalibro.
GetRowsByBookmark	Recupera le righe che corrispondono ai segnalibri specificati.
Hash	Restituisce i valori hash per i bookmark specificati.

Membri di dati

m_rgBookmarks

Una matrice segnalibri.

Note

IRowsetLocateImpl è l'implementazione dei modelli OLE DB dell'interfaccia di L'interfaccia IRowsetLocate. IRowsetLocate viene utilizzato per recuperare le righe arbitrarie di un rowset. Un rowset che non implementa questa interfaccia è un rowset di sequential. Quando IRowsetLocate è presente in un rowset, la colonna 0 è il segnalibro per le righe; la lettura di questa colonna visualizzerà un valore del segnalibro che può essere utilizzato per riposizionare la stessa riga.

IRowsetLocateImpl viene utilizzato per implementare il supporto per i bookmark nel provider. I segnalibri sono segnaposto (indici in un rowset che consente al consumer per restituire rapidamente a una riga, consentendo l'accesso ai dati ad alta velocità. Il provider determina che segnalibri possono identificare in modo univoco una riga. Utilizzando i metodi di IRowsetLocateImpl, è possibile confrontare i segnalibri, le righe di recupero da offset, le righe di recupero dal segnalibro e i valori hash di tornare ai segnalibri.

Per supportare i segnalibri OLE DB in un rowset, sul rowset ereditare dalla classe.

Per informazioni sull'implementazione del supporto per i bookmark, vedere Supporto dei bookmark nel provider in Visual C++ Programmer's Guide e Bookmarks in OLE DB Programmer's Reference in PlatformSDK.