Classe IRowsetLocateImpl

Articolo
03/05/2013

Implementa l'interfaccia OLE DB 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 LUNGO o una stringa.I segnalibri comuni devono avere una lunghezza pari almeno a due byte.(Lunghezza a byte singolo è riservata per OLE DB segnalibri standardDBBMK_FIRST, DBBMK_LASTe DBBMK_INVALID).
BookmarkType
Il meccanismo di mapping per gestire 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 librerie righe 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 segnalibri specificati.

Membri di dati

m_rgBookmarks

Una matrice di segnalibri.

Note

IRowsetLocateImpl è l'implementazione dei modelli OLE DB dell'interfaccia di IRowsetLocate .IRowsetLocate viene utilizzato per recuperare le righe arbitrarie di un rowset.Un rowset che non implementa questa interfaccia è un set di righe 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 alla stessa riga.

IRowsetLocateImpl viene utilizzato per implementare il supporto per i bookmark in provider.I segnalibri sono segnaposto (indici in un rowset che consente all'utente 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 La guida del CD di Visual C++ e segnalibri in OLE DB Programmer's Reference in PlatformSDK.