Sdílet prostřednictvím


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ů

CRowsetImpl

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::GetNextRowssouboru .

IAccessorImpl
OLE DB vyžaduje, aby zprostředkovatelé implementovali HACCESSOR, což je značka pole DBBINDING struktur. Poskytuje HACCESSORadresy 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 CreateSchemaRowsettemplatized 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 IAccessorImpljsou 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, ISessionPropertiesa IRowsetInfo).

IErrorRecordsImpl

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