Klasa IRowsetLocateImpl

Artykuł
02/27/2013

Implementuje OLE DB IRowsetLocate interfejs, który pobiera wiersze dowolnego z zestawu wierszy.

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
>

Parametry

T
Klasa pochodna od IRowsetLocateImpl.
RowsetInterface
Klasa pochodna od IRowsetImpl.
RowClass
Jednostki składowania dla HROW.
MapClass
Jednostki składowania dla wszystkich uchwytów wierszy posiadanych przez dostawcę.
BookmarkKeyType
Typ zakładki, takie jak DŁUGĄ lub ciąg.Zwykłe zakładki muszą mieć długość co najmniej dwa bajty.(Jednobajtowe długość jest zarezerwowana dla OLE DB zakładki standardDBBMK_FIRST, DBBMK_LAST, i DBBMK_INVALID.)
BookmarkType
Mechanizm mapowania dla utrzymania relacje zakładki do danych.
BookmarkMapClass
Zakładki w posiadaniu jednostki składowania dla wszystkich uchwytów wierszy.

Członkowie

Metody interfejsu

Porównaj	Porównuje dwie zakładki.
GetRowsAt	Pobiera wiersze, począwszy od wiersza określonego przez przesunięcie z zakładki.
GetRowsByBookmark	Pobiera wiersze, które odpowiadają określonym zakładki.
Hash	Zwraca wartość mieszania wartości dla określonej zakładki.

Członkowie danych

m_rgBookmarks

Tablica zakładki.

Uwagi

IRowsetLocateImplImplementacja szablonów OLE DB IRowsetLocate interfejsu.IRowsetLocatejest używana do pobierania wierszy dowolnego z zestawu wierszy.Zestaw wierszy, który nie implementuje ten interfejs jest sequential zestawu wierszy.Gdy IRowsetLocate jest obecny na wierszy, kolumn 0 jest zakładki dla wierszy; czytanie w tej kolumnie będą uzyskiwać wartość zakładki, używany na tym samym wierszu.

IRowsetLocateImplSłuży do wdrożenia wsparcia zakładki w dostawców.Zakładki są symbolami zastępczymi (wskaźniki na wierszy) umożliwiających konsumentowi szybkiego powrotu do wiersza, umożliwiające szybki dostęp do danych.Dostawca ustali, co zakładki można jednoznacznie zidentyfikować wiersza.Za pomocą IRowsetLocateImpl metod, można porównać zakładki, wiersze pobrania przez przesunięcie, pobranie wierszy zakładką i zwraca wartości mieszania dla zakładki.

Do obsługi baz danych OLE zakładki w zestawu wierszy, należy zestawu wierszy, które dziedziczą z tej klasy.

Informacje na Implementowanie obsługi zakładki, zobacz Dostawca obsługuje zakładek w Visual C++ Programmer's Guide i zakładki w OLE DB Programmer's Reference w PlatformSDK.