Referenční dokumentace k šablonám zprostředkovatelů OLE DB
Třídy a rozhraní pro šablony zprostředkovatele OLE DB lze seskupit do následujících kategorií. Referenční materiál obsahuje také informace o makrech pro šablony zprostředkovatele OLE DB.
Třídy používají následující zásady vytváření názvů: třída pojmenovaná vzorem IWidgetImpl
by poskytovala implementaci rozhraní IWidget
.
Třídy relací
IDBCreateSessionImpl
Vytvoří novou relaci z objektu zdroje dat a vrátí požadované rozhraní v nově vytvořené relaci. Povinné rozhraní pro objekty zdroje dat.
ISessionPropertiesImpl
Implementuje vlastnosti relace voláním statické funkce definované mapou sady vlastností. Mapa sady vlastností by měla být zadána ve vaší třídě relace. Povinné rozhraní relací.
Třídy sady řádků
Poskytuje standardní implementaci sady řádků OLE DB bez nutnosti vícenásobné dědičnosti mnoha implementačních rozhraní. Jedinou metodou, pro kterou je nutné zadat implementaci, je Execute
.
CSimpleRow
Poskytuje výchozí implementaci pro popisovač řádku, který se používá ve IRowsetImpl
třídě. Popisovač řádku je logicky jedinečnou značkou pro řádek výsledku. IRowsetImpl
vytvoří novou CSimpleRow
pro každý řádek požadovaný v IRowsetImpl::GetNextRows
souboru .
IAccessorImpl
OLE DB vyžaduje, aby zprostředkovatelé implementovali HACCESSOR
, což je značka pole DBBINDING
struktur. Poskytuje HACCESSOR
adresy BindType
struktur. Povinné u sad řádků a příkazů.
IColumnsInfoImpl
Deleguje na statickou funkci definovanou mapou sloupců zprostředkovatele. Povinné rozhraní sad řádků a příkazů.
IConvertTypeImpl
Poskytuje informace o dostupnosti převodů typů v příkazu nebo v sadě řádků. Povinné u příkazů, sad řádků a sad řádků indexu. Implementuje IConvertType
rozhraní delegováním na objekt převodu, který poskytuje OLE DB.
IDBSchemaRowsetImpl
Implementuje IDBSchemaRowset
rozhraní a funkci CreateSchemaRowset
templatized creator .
IOpenRowsetImpl
Otevře a vrátí sadu řádků, která obsahuje všechny řádky z jedné základní tabulky nebo indexu. Povinné rozhraní pro objekt relace.
IRowsetChangeImpl
Implementuje rozhraní OLE DB IRowsetChange , které umožňuje aktualizovat hodnoty sloupců v existujících řádcích, odstranit řádky a vložit nové řádky.
IRowsetCreatorImpl
Tato třída dědí z IObjectWithSite a přepisuje IObjectWithSite::SetSite. IRowsetCreatorImpl
provádí stejné funkce jako IObjectWithSite
funkce, ale také umožňuje OLE DB vlastnosti DBPROPCANSCROLLBACKWARDS
a DBPROPCANFETCHBACKWARDS
.
IRowsetIdentityImpl
Implementuje IRowsetIdentity
rozhraní, které umožňuje porovnat, jestli jsou dva řádky dat identické nebo ne.
IRowsetImpl
Poskytuje implementaci IRowset
rozhraní, což je základní rozhraní sady řádků.
IRowsetInfoImpl
Implementuje vlastnosti sady řádků pomocí mapování sady vlastností definované ve vaší třídě příkazů. Povinné rozhraní u sad řádků.
IRowsetLocateImpl
Implementuje rozhraní OLE DB IRowsetLocate, které načte libovolné řádky ze sady řádků. Chcete-li podporovat záložky OLE DB v sadě řádků, zdědit sadu řádků z této třídy.
IRowsetNotifyCP
Implementuje funkce všesměrového vysílání, které radí naslouchacím procesům v spojovacím bodu IID_IRowsetNotify
změn v obsahu sady řádků. Příjemci, kteří zpracovávají oznámení, implementují IRowsetNotify a zaregistrují je v tomto spojovacím bodu.
IRowsetUpdateImpl
Implementuje rozhraní OLE DB IRowsetUpdate , které uživatelům umožňuje pozdržet přenos změn provedených pomocí IRowsetChange do zdroje dat a vrátit změny zpět před přenosem.
Třídy příkazů
ICommandImpl
Poskytuje implementaci ICommand
rozhraní. Toto rozhraní není viditelné, ale zpracovává ho ICommandTextImpl
. Povinné rozhraní pro objekt příkazu.
ICommandPropertiesImpl
Tato implementace ICommandProperties
rozhraní je poskytována statickou funkcí definovanou BEGIN_PROPSET_MAP
makrem. Povinné u příkazů.
ICommandTextImpl
Nastaví, uloží a vrátí text příkazu. Povinné u příkazů.
IDBCreateCommandImpl
Vytvoří nový příkaz z objektu relace a vrátí požadované rozhraní v nově vytvořeném příkazu. Volitelné rozhraní pro objekty relace.
Jiné třídy příkazů jsou IColumnsInfoImpl
a IAccessorImpl
jsou popsány v části Třídy sady řádků výše.
Třídy zdroje dat
IDBInitializeImpl
Vytvoří a odstraní připojení s příjemcem. Povinné rozhraní pro objekty zdroje dat a volitelné rozhraní pro enumerátory.
IDBPropertiesImpl
IDBProperties
je povinné rozhraní pro objekty zdroje dat a volitelné rozhraní pro enumerátory. Pokud však enumerátor zveřejňuje IDBInitialize
, musí vystavit IDBProperties
(vlastnosti ve zdroji dat).
IGetDataSourceImpl
Získá ukazatel rozhraní na objekt zdroje dat. Povinné rozhraní relace.
Jiné třídy
CUtlProps
Implementuje vlastnosti pro různá rozhraní vlastností OLE DB (například IDBProperties
, ISessionProperties
a IRowsetInfo
).
Implementuje rozhraní OLE DB IErrorRecords , přidává záznamy do a načítá záznamy z datového členu.
Viz také
Referenční dokumentace k šablonám příjemců OLE DB
Šablony OLE DB