Ukládání dat pomocí metod TableAdapter DBDirect v aplikacích rozhraní .NET Framework
Poznámka:
Datové sady a související třídy jsou staršími technologiemi rozhraní .NET Framework z počátku 2000, které aplikacím umožňují pracovat s daty v paměti, zatímco aplikace jsou odpojené od databáze. Tyto technologie jsou zvláště užitečné pro aplikace, které uživatelům umožňují upravovat data a uchovávat změny zpět do databáze. I když se datové sady ukázaly jako velmi úspěšná technologie, doporučujeme, aby nové aplikace .NET používaly Entity Framework Core. Entity Framework poskytuje přirozenější způsob práce s tabulkovými daty jako objektovými modely a má jednodušší programovací rozhraní.
Tento kurz obsahuje podrobné pokyny pro spouštění příkazů SQL přímo v databázi pomocí metod DBDirect objektu TableAdapter. Metody DBDirect objektu TableAdapter poskytují podrobnou úroveň kontroly nad aktualizacemi databáze. Můžete je použít ke spuštění konkrétních příkazů SQL a uložených procedur voláním jednotlivých Insert
, Update
a Delete
metod podle potřeby vaší aplikace (na rozdíl od přetížené Update
metody, která provádí UPDATE
, INSERT
a DELETE
příkazy všechny v jednom volání).
V tomto kurzu se naučíte:
Vytvořte a nakonfigurujte datovou sadu pomocí Průvodce konfigurací zdroje dat.
Vyberte ovládací prvek, který se má vytvořit ve formuláři při přetažení položek z okna Zdroje dat. Další informace naleznete v tématu Nastavení ovládacího prvku, který se má vytvořit při přetažení z okna Zdroje dat.
Vytvořte formulář vázaný na data přetažením položek z okna Zdroje dat do formuláře.
Přidejte metody pro přímý přístup k databázi a provádění vkládání, aktualizací a odstraňování.
Požadavky
Kroky v tomto kurzu fungují s rozhraním .NET Framework model Windows Forms Applications.
Tento kurz používá SQL Server Express LocalDB a ukázkovou databázi Northwind.
Pokud nemáte SQL Server Express LocalDB, nainstalujte ho buď ze stránky pro stažení SQL Serveru Express, nebo prostřednictvím Instalační program pro Visual Studio. V Instalační program pro Visual Studio můžete sql Server Express LocalDB nainstalovat jako součást úlohy ukládání a zpracování dat nebo jako jednotlivé komponenty.
Následujícím postupem nainstalujte ukázkovou databázi Northwind:
V sadě Visual Studio otevřete okno Průzkumník objektů SQL Serveru. (SQL Server Průzkumník objektů se instaluje jako součást úlohy ukládání a zpracování dat v Instalační program pro Visual Studio.) Rozbalte uzel SQL Serveru. Klikněte pravým tlačítkem na instanci LocalDB a vyberte Nový dotaz.
Otevře se okno editoru dotazů.
Zkopírujte do schránky skript Northwind Transact-SQL. Tento skript T-SQL vytvoří zcela novou databázi Northwind a naplní ji daty.
Vložte skript T-SQL do editoru dotazů a pak zvolte tlačítko Spustit .
Po krátké době se dotaz dokončí a vytvoří se databáze Northwind.
Vytvoření model Windows Forms aplikace
Prvním krokem je vytvoření aplikace model Windows Forms (.NET Framework). Vytvořte projekt pomocí typu projektu aplikace model Windows Forms pomocí jazyka C# nebo Visual Basicu.
Poznámka:
Kód pro tento kurz je k dispozici v jazyce C# a Visual Basic. Pokud chcete přepnout jazyk kódu na této stránce mezi jazykem C# a Visual Basicem, použijte přepínač jazyka kódu v horní části stránky na pravé straně.
Vytvoření zdroje dat z databáze
Tento krok používá Průvodce konfigurací zdroje dat k vytvoření zdroje dat na Region
základě tabulky v ukázkové databázi Northwind. Abyste mohli vytvořit připojení, musíte mít přístup k ukázkové databázi Northwind. Informace o nastavení ukázkové databáze Northwind naleznete v tématu Postupy: Instalace ukázkových databází.
Vytvoření zdroje dat
V nabídce Data vyberte Zobrazit zdroje dat.
Otevře se okno Zdroje dat.
V okně Zdroje dat vyberte Přidat nový zdroj dat a spusťte Průvodce konfigurací zdroje dat.
Na obrazovce Zvolit typ zdroje dat vyberte Databázi a pak vyberte Další.
Na obrazovce Zvolit datové připojení udělejte jednu z těchto věcí:
Pokud je datové připojení k ukázkové databázi Northwind k dispozici v rozevíracím seznamu, vyberte ho.
nebo
Výběrem možnosti Nové připojení spusťte dialogové okno Přidat nebo upravit připojení .
Pokud vaše databáze vyžaduje heslo, vyberte možnost zahrnout citlivá data a pak vyberte Další.
Na obrazovce Uložit připojovací řetězec na obrazovce Konfigurační soubor aplikace vyberte Další.
Na obrazovce Zvolit databázové objekty rozbalte uzel Tabulky.
Region
Vyberte tabulku a pak vyberte Dokončit.NorthwindDataSet se přidá do projektu a
Region
tabulka se zobrazí v okně Zdroje dat.
Přidání ovládacích prvků do formuláře pro zobrazení dat
Ovládací prvky vázané na data můžete vytvořit přetažením položek z okna Zdroje dat do formuláře.
Chcete-li vytvořit ovládací prvky vázané na data ve formuláři Windows, přetáhněte hlavní uzel oblasti z okna Zdroje dat do formuláře.
Ovládací DataGridView prvek a pruh nástrojů (BindingNavigator) pro navigaci záznamů se zobrazí ve formuláři. NorthwindDataSet, RegionTableAdapter
a BindingSourceBindingNavigator objeví se v zásobníku komponent.
Přidání tlačítek, která budou volat jednotlivé metody TableAdapter DbDirect
Přetáhněte tři Button ovládací prvky ze sady nástrojů do formuláře Form1 (pod RegionDataGridView).
Na každém tlačítku nastavte následující vlastnosti Název a Text .
Název Text InsertButton
Insert UpdateButton
Update DeleteButton
Odstranění
Přidání kódu pro vložení nových záznamů do databáze
Vyberte InsertButton a vytvořte obslužnou rutinu události pro událost kliknutí a otevřete formulář v editoru kódu.
Obslužnou rutinu
InsertButton_Click
události nahraďte následujícím kódem:private void InsertButton_Click(object sender, EventArgs e) { Int32 newRegionID = 5; String newRegionDescription = "NorthEastern"; try { regionTableAdapter1.Insert(newRegionID, newRegionDescription); } catch (Exception ex) { MessageBox.Show("Insert Failed"); } RefreshDataset(); } private void RefreshDataset() { this.regionTableAdapter1.Fill(this.northwindDataSet1.Region); }
Poznámka:
V závislosti na verzi sady Visual Studio a šablonách projektů, které jste použili, můžou názvy proměnných
regionTableAdapter
jako neboregionTableAdapter1
použité v tomto kódu obsahovat koncovou hodnotu 1 v generovaném kódu. Proveďte všechny opravy v kódu, abyste zajistili, že se správný název použije všude. Visual Studio zobrazuje červenou vlnovku, kde je název nesprávný.
Přidání kódu pro aktualizaci záznamů v databázi
Poklikáním na UpdateButton vytvořte obslužnou rutinu události pro událost kliknutí a otevřete formulář v editoru kódu.
Obslužnou rutinu
UpdateButton_Click
události nahraďte následujícím kódem:
Přidání kódu pro odstranění záznamů z databáze
Vyberte DeleteButton a vytvořte obslužnou rutinu události pro událost kliknutí a otevřete formulář v editoru kódu.
Obslužnou rutinu
DeleteButton_Click
události nahraďte následujícím kódem:
Spuštění aplikace
Výběrem klávesy F5 spusťte aplikaci.
Vyberte tlačítko Vložit a ověřte, že se nový záznam zobrazí v mřížce.
Vyberte tlačítko Aktualizovat a ověřte, že se záznam aktualizuje v mřížce.
Vyberte tlačítko Odstranit a ověřte, že se záznam odebere z mřížky.
Další kroky
V závislosti na požadavcích vaší aplikace můžete po vytvoření formuláře vázaného na data provést několik kroků. Mezi vylepšení, která můžete v tomto kurzu provést, patří:
Přidání funkce vyhledávání do formuláře
Přidání dalších tabulek do datové sady výběrem možnosti Konfigurovat datovou sadu pomocí Průvodce v okně Zdroje dat. Ovládací prvky, které zobrazují související data, můžete přidat přetažením souvisejících uzlů do formuláře. Další informace naleznete v tématu Relace v datových sadách.