Návod: Vytváření TableAdapter s více dotazy
Publikováno: srpen 2016
V tomto návodu vytvoříte prvek TableAdapter v datové sadě pomocí Průvodce konfigurací zdroje dat. Návod vás provede procesem vytvoření druhého dotazu v TableAdapter pomocí TableAdapters – úpravy v Návrháři Dataset.
Úlohy v tomto návodu zahrnují:
Vytvoření nového projektu aplikace systému Windows.
Vytváření a konfigurace zdroje dat v aplikaci sestavením datové sady v průvodci konfigurací zdroje dat.
Otevření nového objektu datové sady v Návrháři datové sady
Přidání dotazů do TableAdapter pomocí Průvodce konfigurací dotazů TableAdapter.
Požadavky
K dokončení tohoto návodu budete potřebovat:
- Přístup k ukázkové databázi Northwind (verze SQL Server nebo Access). Další informace naleznete v tématu Postupy: Instalace ukázkových databází.
Vytvoření nové aplikace systému Windows
Prvním krokem je vytvoření aplikace Windows.
Vytvoření nového projektu aplikace pro systém Windows
V sadě Visual Studio z nabídky Soubor vytvořte nový projekt.
Zvolte programovací jazyk v podokně Typy projektů.
Klikněte na Aplikace systému Windowsv podokně Šablony.
Pojmenujte projekt TableAdapterQueriesWalkthrough a poté klikněte na OK.
Visual Studio přidá projekt do Průzkumníka řešení a zobrazí nový formulář v návrháři.
Vytvoření zdroje dat databáze pomocí prvku TableAdapter
Tento krok vytváří zdroj dat pomocí Průvodce konfigurací zdroje dat na základě tabulky Customers v ukázkové databázi Northwind. Musíte mít přístup k ukázkové databázi Northwind pro vytvoření připojení. Informace o instalaci ukázkové databáze Northwind naleznete zde: Postupy: Instalace ukázkových databází.
Vytvoření zdroje dat
V nabídce Data klikněte na položku Zobrazit zdroje dat.
V okně Zdroje dat výběrem možnosti Přidat nový zdroj dat spusťte Průvodce konfigurací zdroje dat.
Vyberte možnost Databáze na stránce Vybrat typ zdroje dat a potom klikněte na tlačítko Další.
Na stránce Vybrat datové připojení proveďte jeden z následujících kroků:
Pokud je připojení dat k ukázkové databázi Northwind k dispozici v rozevíracím seznamu, vyberte je.
-nebo-
Vybráním možnosti Nové připojení zobrazte dialogové okno Přidat nebo upravit připojení.
Pokud vaše databáze vyžaduje heslo, vyberte možnost zahrnutí důvěrných osobních údajů a pak klikněte na tlačítko Další.
Klepněte na tlačítko Next na stránce Uložit připojovací řetězec do konfiguračního souboru aplikace.
Rozbalte uzel Tabulky na stránce Zvolte vaše databázové objekty.
Vyberte tabulku Zákazníci a potom klikněte na tlačítko Dokončit.
NorthwindDataSet je přidána do projektu a tabulka Zákazníci se zobrazí v okně Zdroje dat.
Otevření objektu datové sady v Návrháři datové sady
Otevření objektu datové sady v Návrháři datové sady
V okně Zdroje dat klikněte na tlačítko NorthwindDataset.
V místní nabídce klikněte na příkaz Upravit DataSet pomocí návrháře.
NorthwindDataset otevře Návrhář DataSet.
Přidání druhého dotazu do CustomersTableAdapter
Průvodce vytvořil datovou sadu s tabulkou dat Zákazníci a CustomersTableAdapter. Tato část návodu přidává druhý dotaz k CustomersTableAdapter.
Přidáni dotazu do CustomersTableAdapter
Přetáhněte Dotaz z karty DataSet na Panelu nástrojů do tabulky Zákazníci.
Otevře se TableAdapters – úpravy.
Vyberte možnost Použít SQL příkazy a potom klikněte na tlačítko Další.
Vyberte VYBRAT, které vrátí řádky a potom klepněte na tlačítko Další.
Přidejte klauzuli WHERE do dotazu, aby vypadal takto:
SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = @City
Poznámka
Pokud používáte verzi Access databáze Northwind, nahraďte parametr @City otazníkem.(SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = ?)
Na stránce Zvolte metody k vytvoření metodu Naplnit DataTable pojmenujte FillByCity.
Poznámka
Metoda Vrátit objekt DataTable není použita v tomto návodu, takže můžete ponechat výchozí název nebo zrušit zaškrtnutí políčka.
Klikněte na tlačítko Další a průvodce zavřete.
Dotaz FillByCity je přidán do CustomersTableAdapter.
Přidání kódu k provedení dalšího dotazu ve formuláři
Provedení dotazu
Vyberte Form1 v nástroji Průzkumník řešení a klepněte na tlačítko Návrhář zobrazení.
Přetáhněte uzel Zákazníci z okna Zdroje dat do Formuláře 1.
Výběrem možnosti Kód z nabídky Zobrazení přejděte na zobrazení kódu.
Nahraďte kód v obslužné rutině události Form1_Load následujícím pro spuštění dotazu FillByCity:
string cityValue = "Seattle"; customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);
Dim cityValue As String = "Seattle" CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)
Spuštění aplikace
Spuštění aplikace
Stiskněte klávesu F5.
Mřížka je plná zákazníků s hodnotou City pro Seattle.
Další kroky
Přidání funkčnosti do aplikace
Přidejte ovládací prvek TextBox a Button a předejte hodnotu v textovém poli do dotazu. (CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, TextBox1.Text)).
Přidejte logiku ověřování k události ColumnChanging nebo RowChanging tabulek dat v objektu datové sady. Další informace naleznete v tématu Ověření dat v datových sadách.
Viz také
TableAdapter – přehled
Vytvořit a konfigurovat objekty TableAdapter
Postupy: Vytváření dotazů TableAdapter
Návody k datům
Připojení k datům v sadě Visual Studio
Příprava vaší aplikace k příjmu dat
Načítání dat do aplikace
Vytvoření vazby ovládacích prvků k datům v sadě Visual Studio
Upravování dat ve vaší aplikaci