Vytvořit a konfigurovat objekty TableAdapter

 

Publikováno: srpen 2016

Objekty TableAdapter umožňují komunikaci mezi aplikací a databáze. Jejich připojení k databázi, spustit dotazy nebo uložené procedury a buď vrátí nová data tabulky nebo vyplnit na existující DataTable s vrácená data. Objekty TableAdapter lze také odeslat aktualizovaná data z aplikace zpět do databáze.

Objekty TableAdapter jsou vytvořeny pro vás proveďte jednu z následujících akcí:

• Spuštění Průvodce konfigurací zdroje dat, výběr buď databáze nebo webové služby typ zdroje dat.

• Přetažením databázových objektů z Průzkumníku serveru na Návrháře Dataset.

Můžete vytvořit nové třídy TableAdapter a nakonfigurovat se zdrojem dat přetažením tabulky adaptér z panelu nástrojů do prázdné oblasti v Návrháři Dataset ploše.

Úvod do objekty TableAdapter, naleznete v části Vyplnění datové sady pomocí TableAdapter.

Poznámka

Váš počítač může v následujících pokynech zobrazovat odlišné názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace najdete v tématu Přizpůsobení integrovaného vývojového prostředí.

Pomocí Průvodce nastavením TableAdapter

Spusťte průvodce a vytvořit nebo upravit objekty TableAdapter a jejich přidružené DataTables. Existující objekty TableAdapter lze konfigurovat v Návrháři Dataset pravým tlačítkem myši na něm.

Pokud nový adaptér tabulky z panelu nástrojů přetáhněte návrháře Dataset se nezvýrazní, Průvodce vás vyzve k zadání zdroj dat, který by se měly připojit adaptér a jaký druh příkazy adaptér by měl používat ke komunikaci s databází, příkazy SQL nebo uložené procedury. Pokud konfigurujete adaptér, který je již přidružen ke zdroji dat to nezobrazí.

• Vytvořit metody k odesílání aktualizací přímo do databáze možnost je ekvivalentní nastavení GenerateDBDirectMethods vlastnost na hodnotu true. Možnost není dostupná, když původní příkaz SQL neposkytuje dostatek informací, nebo dotaz není možné aktualizovat dotaz. Tato situace může nastat, například ve spojení dotazy a dotazy, které vrací jedinou hodnotu (skalární).

• Jestliže zvolíte vytvoření nové uložené procedury, můžete vytvořit v podkladové databázi v závislosti na nastavení zabezpečení a oprávnění pro konkrétní databázi. Pokud nemáte oprávnění k vytvoření nové uložené procedury v databázi, tuto možnost nelze dokončit.

• Můžete také zvolit existující uložené procedury pro Vyberte, Vložit, aktualizace, a Odstranit příkazy objektu TableAdapter. Uložené procedury, které jsou přiřazeny aktualizace příkaz, například je provedeno, pokud je TableAdapter.Update() Metoda je volána.

  Mapování parametrů z vybrané uložené procedury na odpovídající sloupce v tabulce data. Například, pokud uložená procedura přijme parametr s názvem @CompanyName který předává do CompanyName sloupce v tabulce, nastavit zdrojový sloupec z @CompanyName parametr CompanyName.

  Poznámka

  Uložené procedury, která je přiřazena k příkazu SELECT je provedena pomocí volání metody třídy TableAdapter s názvy v dalším kroku průvodce. Výchozí hodnota je Fill, takže je typický kód ke spuštění procedury vyberte TableAdapter.Fill(tableName). Náhradní Fill s názvem přiřadíte-li změnit z výchozí vyplnění, a nahraďte "TableAdapter" skutečný název objektu TableAdapter (například CustomersTableAdapter).

• Upřesnit možnosti v průvodci umožňují generovat příkazy INSERT, UPDATE a DELETE na příkazu SELECT, který je definován na základě Generovat SQL příkazy použijte optimistickou metodu souběžného zpracování a určit, zda chcete-li aktualizovat tabulku dat po INSERT a UPDATE příkazy jsou spouštěny.

Konfigurace objektu TableAdapter Fill – metoda

Někdy můžete změnit schéma tabulky adaptéru. Chcete-li to provést, je upravit adaptéru primárního Fill Metoda. Objekty TableAdapter jsou vytvářeny s hlavní Fill metodu, která definuje schématu přidružené tabulky. Hlavní Fill Metoda je založena na dotazu nebo uložené procedury, jste zadali při původně nakonfigurován TableAdapter; je první metoda (zcela nahoře) v tabulce dat na Vytváření a úpravy typovaných datových sad.

Všechny změny provedené v objektu TableAdapter je hlavní Fill Metoda se projeví ve schématu přidružené tabulky. Například odebráním sloupce z dotazu v hlavním Fill Metoda také odeberete sloupec z přidružené tabulky. Kromě toho odebrání sloupce z hlavní Fill Metoda odeberete sloupec z jakékoliv další dotazy pro tuto TableAdapter.

Můžete použít Průvodce nastavením dotazu TableAdapter můžete vytvořit a upravit další dotazy pro objektu TableAdapter. Tyto další dotazy musí odpovídat schématu tabulky, pokud vracejí skalární hodnotu. Další dotazy mít název, který zadáte (například CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle").)

Chcete-li spustit Průvodce konfigurací dotazu TableAdapter s nový dotaz.

1. Otevřete datovou sadu v Návrháře Dataset.

2. Pokud vytváříte nový dotaz, přetáhněte dotazu objektu z datovou sadu na kartě nástrojů na DataTable, nebo vyberte Přidat dotaz z místní nabídky TableAdapter. Můžete také přetáhnout dotazu objekt na prázdnou oblast Návrháře Dataset, což vytvoří TableAdapter bez přidruženého DataTable. Tyto dotazy jsou omezeny na vrácení jedné hodnoty (skalární) nebo provedení UPDATE, INSERT, nebo odstranění příkazů v databázi.

3. Na Vybrat datové připojení vyberte nebo vytvořte připojení dotazu bude používat.

   Poznámka

   Tato stránka se zobrazí, pouze když Návrhář nemůže určit správné připojení pro použití, nebo když jsou k dispozici žádná připojení.

4. Na Zvolte typ příkazu vyberte z následujících metod načítání dat z databáze:

   • Pomocí SQL příkazy umožňuje typ příkazu SQL vyberte data z databáze.

   • Vytvořit nové uložené procedury – tuto možnost, aby průvodce vytvoření nového uložené procedury (databáze) založené na zadaný příkaz SELECT.

   • Použít existující uložené procedury – tuto možnost vyberte k provedení existující uložené procedury při spuštění dotazu.

Chcete-li spustit Průvodce konfigurací dotazu TableAdapter na existující dotaz

• Pokud upravujete existující dotazu TableAdapter, klikněte dotaz pravým tlačítkem a zvolte Konfigurovat z místní nabídky.

  Poznámka

  Pravým tlačítkem myši na hlavním dotazu TableAdapter překonfigurujete TableAdapter a DataTable schématu, že pravým tlačítkem myši na TableAdapter další dotaz pouze konfiguruje vybraný dotaz.Průvodce nastavením TableAdapter překonfigurujete definice třídy TableAdapter; Průvodce nastavením dotazu TableAdapter překonfigurujete pouze vybraný dotaz.

Chcete-li přidat globální dotaz do objektu TableAdapter

• Globální dotazy jsou dotazy SQL, které vrací jedinou hodnotu (skalární) nebo žádná hodnota. Globální funkce provádějí obvykle, databázových operací, jako je například vložení, aktualizace, odstranění a agregování informace, například vrací počet zákazníků v tabulce nebo celkové náklady pro všechny položky v určitém pořadí.

  Přidávání globálních dotazů přetažením dotazu z DataSet na kartě nástrojů na prázdnou oblast Návrháře Dataset.

• Zadejte dotaz, který provede požadovanou úlohu, například SELECT COUNT(*) AS CustomerCount FROM Customers.

  Poznámka

  Přetahování dotazu přímo do Návrháře Dataset vytvoří metodu, která vrátí pouze skalární hodnota (jeden). Při dotazu nebo uložené procedury, které vyberete může vrátit více než jednu hodnotu, vrátí metoda vytvořené průvodcem pouze jednu hodnotu. Dotaz může například vrátit první sloupec prvního řádku vrácená data.

Viz také

Vyplnění datové sady pomocí TableAdapter