Sdílet prostřednictvím

Průvodce příjemcem ATL OLE DB

  • Článek

Tento průvodce není k dispozici v sadě Visual Studio 2019 a novějších verzích.

Tento průvodce nastaví třídu příjemce OLE DB s datovými vazbami potřebnými pro přístup k zadanému zdroji dat prostřednictvím zadaného zprostředkovatele OLE DB.

Poznámka:

Tento průvodce vyžaduje, abyste před zadáním názvů do Class polí souboru a .h vybrali zdroj dat kliknutím na tlačítko Zdroj dat.

Seznam prvků uživatelského rozhraní

  • Zdroj dat

    Tlačítko Zdroj dat umožňuje nastavit zadaný zdroj dat pomocí zadaného zprostředkovatele OLE DB. Po kliknutí na toto tlačítko se zobrazí dialogové okno Vlastnosti datového propojení. Další informace o vytváření připojovací řetězec a dialogovém okně Vlastnosti datového propojení najdete v tématu Přehled rozhraní DATA LINK API v dokumentaci k sadě Windows SDK.

    Následující další informace popisují karty v dialogovém okně Vlastnosti datového propojení.

    • Karta Zprostředkovatel

      Vyberte vhodného zprostředkovatele, který bude spravovat připojení ke zdroji dat. Typ poskytovatele je obvykle určen typem databáze, ke které se připojujete. Klikněte na tlačítko Další nebo klikněte na kartu Připojení .

    • Karta Připojení

      Obsah této karty závisí na vybraném poskytovateli. I když existuje mnoho typů poskytovatelů, tato část se zabývá připojeními pro dvě nejběžnější: data SQL a ODBC. Ostatní jsou podobné varianty polí popsaných zde.

      Pro data SQL:

      1. Vyberte nebo zadejte název serveru: Kliknutím na rozevírací nabídku zobrazte všechny registrované datové servery v síti a vyberte jeden.

      2. Zadejte informace pro přihlášení k serveru: Zadejte uživatelské jméno a heslo pro přihlášení k datovému serveru.

        Poznámka:

        Došlo k problému se zabezpečením funkce Povolit ukládání hesla v dialogovém okně Vlastnosti datového propojení. V části Zadat informace pro přihlášení k serveru jsou dvě přepínače:

        • Použití integrovaného zabezpečení systém Windows NT
        • Použití konkrétního uživatelského jména a hesla

        Pokud vyberete Použít konkrétní uživatelské jméno a heslo, máte možnost uložit heslo (pomocí zaškrtávacího políčka Povolit ukládání hesla), ale tato možnost není bezpečná. Doporučujeme vybrat možnost Použít systém Windows NT integrované zabezpečení. Tato možnost je zabezpečená, protože zašifruje heslo. Můžou se zde vyskytovat situace, kdy chcete vybrat Povolit ukládání hesla. Pokud například vydáváte knihovnu s privátním databázovým řešením, neměli byste k databázi přistupovat přímo, ale místo toho použijte aplikaci střední vrstvy k ověření uživatele (prostřednictvím libovolného schématu ověřování, které zvolíte) a pak omezte typ dat, která jsou uživateli k dispozici.

      3. Vyberte databázi na serveru: Kliknutím na rozevírací nabídku zobrazte všechny registrované databáze na datovém serveru a vyberte jednu databázi.

        - nebo -

        Připojte soubor databáze jako název databáze: Zadejte soubor, který se má použít jako databáze. Zadejte explicitní název cesty.

      Pro data ODBC:

      1. Zadejte zdroj dat: Můžete použít název zdroje dat nebo připojovací řetězec.

        Použít název zdroje dat: Tento rozevírací seznam zobrazuje zdroje dat zaregistrované ve vašem počítači. Zdroje dat můžete nastavit předem pomocí správce zdroje dat ODBC.

        - nebo -

        Použít připojovací řetězec: Zadejte připojovací řetězec, které jste již získali, nebo klikněte na tlačítko Sestavit; zobrazí se dialogové okno Vybrat zdroj dat. Vyberte soubor nebo zdroj dat počítače a klikněte na TLAČÍTKO OK.

        Poznámka:

        Můžete získat připojovací řetězec zobrazením vlastností existujícího připojení v Průzkumníku serveru nebo poklikáním na Přidat připojení v Průzkumníku serveru.

      2. Zadejte informace pro přihlášení k serveru: Zadejte uživatelské jméno a heslo pro přihlášení k datovému serveru.

      3. Zadejte počáteční katalog, který chcete použít.

      4. Klepněte na tlačítko Test připojení; pokud je test úspěšný, klepněte na tlačítko OK. Pokud ne, zkontrolujte přihlašovací údaje, zkuste jinou databázi nebo zkuste jiný datový server.

    • Karta Upřesnit

      Nastavení sítě: Zadejte úroveň zosobnění (úroveň zosobnění, kterou může server používat při zosobnění klienta; odpovídá přímo úrovním zosobnění RPC) a úroveň ochrany (úroveň ochrany dat odesílaných mezi klientem a serverem, odpovídá přímo úrovním ochrany RPC).

      Další: V časovém limitu připojení zadejte počet sekund času nečinnosti povolený před vypršením časového limitu. V accessových oprávněních zadejte přístupová oprávnění k datovému připojení.

      Další informace o pokročilých inicializačních vlastnostech najdete v dokumentaci, která je k dispozici u každého konkrétního zprostředkovatele OLE DB.

    • Karta Vše

      Tato karta zobrazuje souhrn vlastností inicializace pro zdroj dat a připojení, které jste zadali. Tyto hodnoty můžete upravit.

      Kliknutím na OK vytváření dokončete. Zobrazí se dialogové okno Vybrat databázový objekt . V tomto dialogovém okně vyberte tabulku, zobrazení nebo uloženou proceduru, kterou bude příjemce používat.

  • Třída

    Po výběru zdroje dat se toto pole naplní výchozím názvem třídy na základě vybrané tabulky nebo uložené procedury (viz níže Výběr zdroje dat). Název třídy můžete upravit.

  • Soubor .h

    Po výběru zdroje dat se toto pole naplní výchozím názvem třídy záhlaví na základě vybrané tabulky nebo uložené procedury (viz níže Výběr zdroje dat). Můžete upravit název souboru záhlaví nebo vybrat existující soubor záhlaví.

  • Mající znak

    Tato možnost určuje, zda průvodce vytvoří třídy příjemců pomocí atributů nebo deklarací šablony. Když vyberete tuto možnost, průvodce místo deklarací šablony používá atributy (toto je výchozí možnost). Když tuto možnost zrušíte, průvodce místo atributů použije deklarace šablony.

    • Pokud vyberete typ tabulky příjemce, průvodce pomocí db_source atributů db_table vytvoří deklarace třídy tabulek a přístupových objektů tabulky a použije db_column k vytvoření mapy sloupců. Vytvoří například tuto mapu:

      // Inject table class and table accessor class declarations
[db_source("<initialization_string>"), db_table("dbo.Orders")]
...
// Column map
[ db_column(1, status=m_dwOrderIDStatus, length=m_dwOrderIDLength) ] LONG m_OrderID;
[ db_column(2, status=m_dwCustomerIDStatus, length=m_dwCustomerIDLength) ] TCHAR m_CustomerID[6];
...

      místo použití CTable třídy šablony k deklarování třídy tabulek a přístupových objektů tabulky a BEGIN_COLUMN_MAP a END_COLUMN_MAP makra k vytvoření mapy sloupců, jak je znázorněno v tomto příkladu:

      // Table accessor class
    class COrdersAccessor; // Table class
    class COrders : public CTable<CAccessor<COrdersAccessor>>;
// ...
// Column map
    BEGIN_COLUMN_MAP(COrderDetailsAccessor)
        COLUMN_ENTRY_LENGTH_STATUS(1, m_OrderID, m_dwOrderIDLength, m_dwOrderIDStatus)
        COLUMN_ENTRY_LENGTH_STATUS(2, m_CustomerID, m_dwCustomerIDLength, m_dwCustomerIDStatus)
        // ...
    END_COLUMN_MAP()

    • Pokud vyberete typ příkazu příjemce, průvodce použije db_source atributy a db_command použije db_column k vytvoření mapy sloupců. Vytvoří například tuto mapu:

      [db_source("<initialization_string>"), db_command("SQL_command")]
...
// Column map using db_column is the same as for consumer type of 'table'

      místo použití deklarací třídy příkazového objektu a přístupového objektu v souboru .h třídy příkazů, například:

      // Command accessor class:
    class CListOrdersAccessor;
// Command class:
    class CListOrders : public CCommand<CAccessor<CListOrdersAccessor>>;
// ...
// Column map using BEGIN_COLUMN_MAP ... END_COLUMN_MAP is the same as
// for consumer type of 'table'

      Další informace najdete v základní mechanikě atributů .

  • Typ

    Vyberte jedno z těchto přepínačů a určete, zda bude třída příjemce odvozena od CTable nebo CCommand (výchozí).

    • Tabulka

      Tuto možnost vyberte, pokud chcete použít CTable nebo db_table vytvořit deklarace třídy tabulek a přístupových objektů tabulky.

    • Příkaz

      Tuto možnost vyberte, pokud chcete použít CCommand nebo db_command vytvořit deklarace třídy příkazového objektu a přístupového objektu. Toto je výchozí výběr.

  • Podpora

    Zaškrtnutím políček určete typy aktualizací, které se mají v příjemci podporovat (výchozí hodnota není žádná). Každý z následujících nastavení nastaví DBPROP_IRowsetChange a příslušné položky pro DBPROP_UPDATABILITY v mapě sady vlastností.

    • Změnit

      Určuje, že příjemce podporuje aktualizace dat řádků v sadě řádků.

    • Insert

      Určuje, že příjemce podporuje vkládání řádků do sady řádků.

    • Odstranění

      Určuje, že příjemce podporuje odstranění řádků ze sady řádků.

Viz také

Příjemce ATL OLE DB
Přidání funkce pomocí Průvodců kódem
Připojovací řetězce a datové odkazy (OLE DB)