CRowsetImpl – třída

Poskytuje standardní implementaci sady řádků OLE DB bez nutnosti vícenásobné dědičnosti mnoha implementačních rozhraní.

Syntaxe

template <
   class T,
   class Storage,
   class CreatorClass,
   class ArrayType = CAtlArray<Storage>,
   class RowClass = CSimpleRow,
   class RowsetInterface = IRowsetImpl <T, IRowset>
>
class CRowsetImpl :
   public CComObjectRootEx<CreatorClass::_ThreadModel>,
   public CRowsetBaseImpl<T, Storage, ArrayType, RowsetInterface>,
   public IRowsetInfoImpl<T, CreatorClass::_PropClass>

Parametry

T
Třída uživatele, která je odvozena od CRowsetImpl.

Úložiště
Třída záznamu uživatele.

CreatorClass
Třída, která obsahuje vlastnosti sady řádků; obvykle příkaz.

ArrayType
Třída, která bude fungovat jako úložiště pro data sady řádků. Tento parametr má výchozí hodnotu CAtlArray, ale může to být libovolná třída, která podporuje požadované funkce.

Požadavky

Hlavička: atldb.h

Členové

Metody

Přepisovatelné metody

Datové členy

Poznámky

CRowsetImpl poskytuje přepsání ve formě statických upcastů. Metody řídí způsob, jakým daná sada řádků ověří text příkazu. Vlastní třídu stylu můžete vytvořit CRowsetImpltak, že rozhraní implementace zdědí vícenásobně. Jedinou metodou, pro kterou je nutné zadat implementaci, je Execute. V závislosti na typu sady řádků, kterou vytváříte, budou metody tvůrce očekávat různé podpisy Execute. Pokud například k implementaci sady řádků schématu používáte odvozenou CRowsetImpltřídu, Execute bude mít metoda následující podpis:

HRESULT Execute(LONG* pcRows, ULONG cRestrictions, const VARIANT* rgRestrictions)

Pokud vytváříte -odvozenou CRowsetImpltřídu pro implementaci sady řádků příkazu nebo relace, Execute metoda bude mít následující podpis:

HRESULT Execute(LONG* pcRows, DBPARAMS* pParams)

Pokud chcete implementovat některou CRowsetImplz metod odvozených Execute od -, je nutné vyplnit interní vyrovnávací paměti dat (m_rgRowData).

CRowsetImpl::NameFromDBID

Extrahuje řetězec z řetězce DBID a zkopíruje ho do řetězce bstr předaného.

Syntaxe

HRESULT CRowsetBaseImpl::NameFromDBID(DBID* pDBID,
   CComBSTR& bstr,
   bool bIndex);

Parametry

pDBID
[v] Ukazatel na DBID řetězec, ze kterého chcete extrahovat řetězec.

bstr
[v] Odkaz CComBSTR pro umístění kopie DBID řetězce.

bIndex
[v] true pokud index DBID; false pokud tabulka DBID.

Návratová hodnota

Standardní HODNOTA HRESULT. V závislosti na tom, zda DBID je tabulka nebo index (označeno bIndex), metoda vrátí DB_E_NOINDEX nebo DB_E_NOTABLE.

Poznámky

Tato metoda je volána CRowsetImpl implementace ValidateCommandID a GetCommandFromID.

CRowsetImpl::SetCommandText

Ověří a uloží DBIDs do dvou řetězců (m_strCommandText a m_strIndexText).

Syntaxe

HRESULT CRowsetBaseImpl::SetCommandText(DBID* pTableID,
   DBID* pIndexID);

Parametry

pTableID
[v] Ukazatel na reprezentaci DBID ID tabulky.

pIndexID
[v] Ukazatel na reprezentaci DBID ID indexu.

Návratová hodnota

Standardní HODNOTA HRESULT.

Poznámky

Metoda SetCommentText je volána CreateRowsetstatickou metodou šablony IOpenRowsetImpl.

Tato metoda deleguje svou práci voláním ValidateCommandID a GetCommandFromID prostřednictvím upcasted ukazatele.

CRowsetImpl::GetColumnInfo

Načte informace o sloupci pro konkrétní požadavek klienta.

Syntaxe

static ATLCOLUMNINFO* CRowsetBaseImpl::GetColumnInfo(T* pv,
   ULONG* pcCols);

Parametry

Pv
[v] Ukazatel na odvozenou CRowsetImpl třídu uživatele.

pcCols
[v] Ukazatel (výstup) na počet vrácených sloupců.

Návratová hodnota

Ukazatel na statickou ATLCOLUMNINFO strukturu.

Poznámky

Tato metoda je rozšířená přepsání.

Tato metoda je volána několika základními třídami implementace k načtení informací o sloupci pro konkrétní požadavek klienta. Obvykle by tato metoda byla volána IColumnsInfoImpl. Pokud tuto metodu přepíšete, musíte do své -odvozené třídy umístit verzi metody CRowsetImpl. Vzhledem k tomu, že metoda může být umístěna v jiné než templatizované třídě, musíte změnit pv na odpovídající CRowsetImpl-odvozenou třídu.

Následující příklad ukazuje GetColumnInfo použití. V tomto příkladu CMyRowset je -odvozená CRowsetImpltřída. Chcete-li přepsat GetColumnInfo pro všechny instance této třídy, umístěte do definice třídy následující metodu CMyRowset :

static ATLCOLUMNINFO* GetColumnInfo(CCustomRowset* pRowset, DBORDINAL* pcCols)
{
   // Add your implementation here and/or call the base class

   return CRowsetImpl::GetColumnInfo(pRowset, pcCols);
}

CRowsetImpl::GetCommandFromID

Zkontroluje, jestli oba parametry obsahují řetězcové hodnoty, a pokud ano, zkopíruje řetězcové hodnoty do datových členů m_strCommandText a m_strIndexText.

Syntaxe

HRESULT CRowsetBaseImpl::GetCommandFromID(DBID* pTableID,
   DBID* pIndexID);

Parametry

pTableID
[v] Ukazatel na reprezentaci DBID ID tabulky.

pIndexID
[v] Ukazatel na reprezentaci DBID ID indexu.

Návratová hodnota

Standardní HODNOTA HRESULT.

Poznámky

Tato metoda se volá prostřednictvím statického upcastu, CRowsetImpl který naplní datové členy m_strCommandText a m_strIndexText. Ve výchozím nastavení tato metoda kontroluje, jestli oba parametry obsahují řetězcové hodnoty. Pokud obsahují řetězcové hodnoty, tato metoda zkopíruje řetězcové hodnoty do datových členů. Umístěním metody s tímto podpisem do CRowsetImpl-odvozené třídy bude vaše metoda volána místo základní implementace.

CRowsetImpl::ValidateCommandID

Zkontroluje, jestli některé nebo obě DBIDhodnoty obsahují řetězcové hodnoty, a pokud ano, zkopíruje je do svých datových členů m_strCommandText a m_strIndexText.

Syntaxe

HRESULT CRowsetBaseImpl::ValidateCommandID(DBID* pTableID,
   DBID* pIndexID);

Parametry

pTableID
[v] Ukazatel na reprezentaci DBID ID tabulky.

pIndexID
[v] Ukazatel na reprezentaci DBID ID indexu.

Návratová hodnota

Standardní HODNOTA HRESULT.

Poznámky

Tato metoda se volá prostřednictvím statického upcastu, který CRowsetImpl naplní své datové členy m_strCommandText a m_strIndexText. Ve výchozím nastavení tato metoda kontroluje, jestli buď nebo obě DBIDobsahují řetězcové hodnoty, a pokud ano, zkopíruje je do svých datových členů. Umístěním metody s tímto podpisem do CRowsetImpl-odvozené třídy bude vaše metoda volána místo základní implementace.

CRowsetImpl::m_rgRowData

Ve výchozím nastavení CAtlArray šablona šablony uživatele, která šablonuje argument šablony CRowsetImplpro .

Syntaxe

ArrayType CRowsetBaseImpl::m_rgRowData;

Poznámky

ArrayType je parametr šablony pro CRowsetImpl.

CRowsetImpl::m_strCommandText

Obsahuje počáteční příkaz sady řádků.

Syntaxe

CComBSTR CRowsetBaseImpl::m_strCommandText;

CRowsetImpl::m_strIndexText

Obsahuje počáteční index sady řádků.

Syntaxe

CComBSTR CRowsetBaseImpl::m_strIndexText;