IRowsetLocateImpl 類別

發行項
02/28/2013

實作 OLE DB IRowsetLocate 介面，從一個資料列集擷取任意資料列。

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
>

參數

T
一個類別衍生自IRowsetLocateImpl。
RowsetInterface
一個類別衍生自IRowsetImpl。
RowClass
儲存單位的 HROW。
MapClass
提供者所持有的所有資料列控制代碼儲存單位。
BookmarkKeyType
書籤，例如一個長整數或字串的型別。一般的書籤必須要有一段至少兩個位元組。 (單一位元組的長度保留給 OLE DB 標準的書籤DBBMK_FIRST， DBBMK_LAST，以及 DBBMK_INVALID。)
BookmarkType
對應的機制，讓您維護書籤-資料關聯性。
BookmarkMapClass
書籤所持有的所有資料列控制代碼儲存單位。

Members

介面方法

Compare	比較兩個書籤。
GetRowsAt	擷取開頭的位移，從書籤所指定的資料列的資料列。
GetRowsByBookmark	擷取符合指定的書籤的資料列。
雜湊	傳回雜湊指定的書籤的值。

資料成員

m_rgBookmarks

書籤陣列。

備註

IRowsetLocateImpl是的 OLE DB 樣板實作 IRowsetLocate 介面。 IRowsetLocate用來從資料列集擷取任意資料列。未實作這個介面的資料列集是sequential資料列集。當IRowsetLocate存在於資料列集，0 的資料行是書籤的資料列。閱讀本專欄將會取得可以用來重新定位到同一個資料列的書籤值。

IRowsetLocateImpl用來在提供者中實作的書籤支援。書籤是版面配置區 (資料列集的索引)，可讓取用者快速返回一列，請允許高速資料的存取權。提供者會有什麼書籤可唯一識別資料列。使用IRowsetLocateImpl方法，您可以比較 [書籤、提取資料列的位移，擷取資料列的書籤]，並傳回書籤的雜湊值。

若要在資料列集支援 OLE DB 的書籤，請從這個類別繼承的資料列集。

如需實作書籤支援，請參閱提供者支援書籤在 Visual C++ 程式設計人員指南和書籤在 OLE DB 程式設計人員參考在PlatformSDK。