Ukládání dat pomocí metod TableAdapter DBDirect

Platí pro:yesnokód Visual Studio Visual Studio pro Mac noVisual Studio

Tento kurz obsahuje podrobné pokyny pro spuštění příkazů SQL přímo v databázi pomocí metod DBDirect tableAdapter. Metody DBDirect tableAdapter poskytují podrobnou úroveň kontroly nad aktualizacemi databáze. Můžete je použít ke spouštění konkrétních příkazů SQL a uložených procedur voláním jednotlivých Insert, Updatea Delete metod podle potřeby vaší aplikace (na rozdíl od přetížené Update metody, která provádí příkazy UPDATE, INSERT a DELETE všechny v jednom volání).

Během tohoto kurzu se naučíte:

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.

  1. Pokud nemáte SQL Server Express LocalDB, nainstalujte ho buď ze stránky pro stažení SQL Server Express, nebo prostřednictvím Instalační program pro Visual Studio. V Instalační program pro Visual Studio můžete nainstalovat SQL Server Express LocalDB jako součást úlohy ukládání a zpracování dat nebo jako jednotlivá komponenta.

  2. Pomocí následujícího postupu nainstalujte ukázkovou databázi Northwind:

    1. V Visual Studio otevřete okno SQL Server Průzkumník objektů. (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 Server. Klikněte pravým tlačítkem na instanci LocalDB a vyberte Nový dotaz.

      Otevře se okno editoru dotazů.

    2. Zkopírujte skript Northwind Transact-SQL do schránky. Tento skript T-SQL vytvoří databázi Northwind úplně od začátku a naplní ji daty.

    3. 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í aplikace model Windows Forms

Prvním krokem je vytvoření aplikace model Windows Forms. Vytvořte projekt pomocí typu projektu aplikace model Windows Forms pomocí jazyka C# nebo Visual Basic.

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 Basic, 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 najdete v tématu Postupy: Instalace ukázkových databází.

Vytvoření zdroje dat

  1. V nabídce Data vyberte Zobrazit zdroje dat.

    Otevře se okno Zdroje dat .

  2. V okně Zdroje dat vyberte Přidat nový zdroj dat a spusťte Průvodce konfigurací zdroje dat.

  3. Na obrazovce Zvolit typ zdroje dat vyberte Databázi a pak vyberte Další.

  4. Na obrazovce Zvolit datové připojení udělejte jednu z těchto věcí:

    • Pokud je připojení dat k ukázkové databázi Northwind k dispozici v rozevíracím seznamu, vyberte je.

      -nebo-

    • Výběrem možnosti Nové připojení spusťte dialogové okno Přidat nebo upravit připojení .

  5. Pokud vaše databáze vyžaduje heslo, vyberte možnost zahrnout citlivá data a pak vyberte Další.

  6. Na obrazovce Uložit připojovací řetězec do konfiguračního souboru aplikace vyberte Další.

  7. Na obrazovce Zvolit databázové objekty rozbalte uzel Tabulky .

  8. 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

Vytvořte ovládací prvky vázané na data 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 pás nástrojů (BindingNavigator) pro navigaci v záznamech se zobrazí ve formuláři. NorthwindDataSet, RegionTableAdapter, BindingSourcea BindingNavigator zobrazí se v zásobníku komponent.

Přidání tlačítek, která budou volat jednotlivé metody TableAdapter DbDirect

  1. Přetáhněte tři Button ovládací prvky ze sady nástrojů na Form1 (pod regionDataGridView).

  2. Na každém tlačítku nastavte následující vlastnosti Název a Text .

    Name Text
    InsertButton Insert
    UpdateButton Aktualizace
    DeleteButton Odstranit

Přidání kódu pro vložení nových záznamů do databáze

  1. Vyberte InsertButton a vytvořte obslužnou rutinu události pro událost kliknutí a otevřete formulář v editoru kódu.

  2. 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 vaší verzi Visual Studio a šablonách projektů, které jste použili, můžou názvy proměnných, jako nebo regionTableAdapterregionTableAdapter1 použité v tomto kódu, nebo nemusí mít v vygenerovaném kódu koncové číslo 1. Proveďte všechny opravy v kódu, abyste měli jistotu, že se správný název používá 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

  1. Poklikáním na Tlačítko UpdateButton vytvořte obslužnou rutinu události pro událost kliknutí a otevřete formulář v editoru kódu.

  2. Obslužnou rutinu UpdateButton_Click události nahraďte následujícím kódem:

    private void UpdateButton_Click(object sender, EventArgs e)
    {
        Int32 newRegionID = 5;
        
        try
        {
            regionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern");
        }
        catch (Exception ex)
        {
            MessageBox.Show("Update Failed");
        }
        RefreshDataset();
    }
    

Přidání kódu pro odstranění záznamů z databáze

  1. Vyberte DeleteButton a vytvořte obslužnou rutinu události pro událost kliknutí a otevřete formulář v editoru kódu.

  2. Obslužnou rutinu DeleteButton_Click události nahraďte následujícím kódem:

    private void DeleteButton_Click(object sender, EventArgs e)
    {
        try
        {
            regionTableAdapter1.Delete(5, "Updated Region Description");
        }
        catch (Exception ex)
        {
            MessageBox.Show("Delete Failed");
        }
        RefreshDataset();
    }
    

Spuštění aplikace

  • Výběrem klávesy F5 aplikaci spusťte.

  • 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 je záznam odebrán z mřížky.

Další kroky

V závislosti na požadavcích na aplikaci můžete po vytvoření formuláře vázaného na data provést několik kroků. Mezi vylepšení tohoto kurzu patří:

  • Přidání funkce vyhledávání do formuláře

  • Přidáním 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 najdete v tématu Relace v datových sadách.

Viz také