Vytvoření uživatelského ovládacího prvku model Windows Forms rozhraní .NET Framework, který podporuje komplexní datovou vazbu s ADO.NET

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

Při zobrazení dat ve formulářích v aplikacích pro Windows můžete zvolit existující ovládací prvky z panelu nástrojů. Nebo můžete vytvořit vlastní ovládací prvky, pokud vaše aplikace vyžaduje funkce, které nejsou dostupné ve standardních ovládacích prvcích. Tento návod ukazuje, jak vytvořit ovládací prvek, který implementuje ComplexBindingPropertiesAttribute. Ovládací prvky, které implementují ComplexBindingPropertiesAttribute , obsahují DataSource a DataMember vlastnost, které lze svázat s daty. Tyto ovládací prvky se podobají nebo DataGridView ListBox.

Další informace o vytváření ovládacích prvků najdete v tématu Vývoj ovládacích prvků model Windows Forms v době návrhu.

Při vytváření ovládacíchprvkůch

Použití atributu datové vazby
Implementujte na DefaultBindingPropertyAttribute jednoduchých ovládacích prvcích, jako je například TextBox, který zobrazuje jeden sloupec (nebo vlastnost) dat. Další informace najdete v tématu Vytvoření model Windows Forms uživatelského ovládacího prvku, který podporuje jednoduchou datovou vazbu.
Implementujte ovládací ComplexBindingPropertiesAttribute prvky, jako je například DataGridView, zobrazující seznamy (nebo tabulky) dat. (Tento proces je popsaný na této stránce návodu.)
LookupBindingPropertiesAttribute Implementujte ovládací prvky, jako je například ComboBox, které zobrazují seznamy (nebo tabulky) dat, ale také potřebují prezentovat jeden sloupec nebo vlastnost. Další informace najdete v tématu Vytvoření model Windows Forms uživatelského ovládacího prvku, který podporuje vazbu vyhledávacích dat.

Tento názorný postup vytvoří komplexní ovládací prvek, který zobrazí řádky dat z tabulky. Tento příklad používá Customers tabulku z ukázkové databáze Northwind. Složitý uživatelský ovládací prvek zobrazí tabulku zákazníků ve vlastním ovládacím DataGridView prvku.

V tomto názorném postupu se naučíte:

• Přidejte do projektu nový uživatelský ovládací prvek .

• Vizuální návrh uživatelského ovládacího prvku

• Implementujte ComplexBindingProperty atribut.

• Vytvořte datovou sadu pomocí Průvodce konfigurací zdroje dat.

• Nastavte tabulku Customers (Zákazníci) v okně Zdroje dat tak, aby používala nový složitý ovládací prvek.

• Nový ovládací prvek přidáte přetažením z okna Zdroje dat do formuláře Form1.

Požadavky

K dokončení tohoto kurzu potřebujete úlohy vývoje desktopových aplikací .NET a ukládání a zpracování dat nainstalované v sadě Visual Studio. Pokud je chcete nainstalovat, otevřete Instalační program pro Visual Studio a zvolte Upravit (nebo Další>úpravy) vedle verze sady Visual Studio, kterou chcete upravit. Viz Úprava sady Visual Studio.

Tento názorný postup 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 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.

2. Následujícím postupem nainstalujte ukázkovou databázi Northwind:

   1. 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ů.

   2. Zkopírujte do schránky skript Northwind Transact-SQL. Tento skript T-SQL vytvoří zcela novou databázi Northwind 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í projektu aplikace model Windows Forms

Prvním krokem je vytvoření projektu aplikace model Windows Forms pro jazyk C# nebo Visual Basic. Pojmenujte projekt ComplexControlWalkthrough.

Přidání uživatelského ovládacího prvku do projektu

Vzhledem k tomu, že tento názorný postup vytvoří komplexní ovládací prvek s vazbou na data z uživatelského ovládacího prvku, přidejte do projektu položku uživatelského ovládacího prvku :

1. V nabídce Projekt zvolte Přidat uživatelský ovládací prvek.

2. Do oblasti Název zadejte ComplexDataGridView a pak vyberte Přidat.

   Do Průzkumník řešení se přidá ovládací prvek ComplexDataGridView a otevře se v návrháři.

Návrh ovládacího prvku ComplexDataGridView

Pokud chcete do uživatelského ovládacího prvku přidat ovládací DataGridView prvek, přetáhněte DataGridView z panelu nástrojů na návrhovou plochu uživatelského ovládacího prvku.

Přidání požadovaného atributu datové vazby

U složitých ovládacích prvků, které podporují datové vazby, můžete implementovat ComplexBindingPropertiesAttribute:

1. Přepněte ovládací prvek ComplexDataGridView do zobrazení kódu. (Na kartě Zobrazit nabídku, vyberte Kód.)

2. Nahraďte kód v následujícím ComplexDataGridView kódu:

   C#

   using System.Windows.Forms;
   
   namespace CS
   {
       [System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")]
       public partial class ComplexDataGridView : UserControl
       {
           public object DataSource
           {
               get{ return dataGridView1.DataSource; }
               set{ dataGridView1.DataSource = value; }
           }
   
           public string DataMember
           {
               get{ return dataGridView1.DataMember; }
               set{ dataGridView1.DataMember = value; }
           }
   
           public ComplexDataGridView()
           {
               InitializeComponent();
           }
       }
   }
   

   VB

   <System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")>
   Public Class ComplexDataGridView
   
       Public Property DataSource() As Object
           Get
               Return DataGridView1.DataSource
           End Get
           Set(ByVal value As Object)
               DataGridView1.DataSource = value
           End Set
       End Property
   
       Public Property DataMember() As String
           Get
               Return DataGridView1.DataMember
           End Get
           Set(ByVal value As String)
               DataGridView1.DataMember = value
           End Set
       End Property
   End Class
   

3. V nabídce Sestavení zvolte Sestavit řešení.

Vytvoření zdroje dat z databáze

Pomocí průvodce konfigurací zdroje dat vytvořte zdroj dat založený na Customers tabulce v ukázkové databázi Northwind:

1. Pokud chcete otevřít okno Zdroje dat, v nabídce Data klikněte na Zobrazit zdroje dat.

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

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

4. Na stránce Zvolit datové připojení proveďte jednu z následujících věcí:

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

   • 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 stránce Uložit připojovací řetězec na konfigurační soubor aplikace klepněte na tlačítko Další.

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

8. Customers Vyberte tabulku a pak vyberte Dokončit.

   NorthwindDataSet se přidá do projektu a Customers tabulka se zobrazí v okně Zdroje dat.

Nastavení tabulky Customers na použití ovládacího prvku ComplexDataGridView

V okně Zdroje dat můžete nastavit, aby se ovládací prvek vytvořil před přetažením položek do formuláře:

1. Otevřete formulář 1 v návrháři.

2. Rozbalte uzel Zákazníci v okně Zdroje dat.

3. Klikněte na šipku rozevíracího seznamu na uzlu Zákazníci a zvolte Přizpůsobit.

4. V seznamu přidružených ovládacích prvků v dialogovém okně Možnosti přizpůsobení uživatelského rozhraní dat vyberte ComplexDataGridView.

5. Klikněte na šipku rozevíracího seznamu v Customers tabulce a v seznamu ovládacích prvků zvolte ComplexDataGridView .

Přidání ovládacích prvků do formuláře

Ovládací prvky vázané na data můžete vytvořit přetažením položek z okna Zdroje dat do formuláře. Přetáhněte hlavní uzel Zákazníci z okna Zdroje dat do formuláře. Ověřte, že se k zobrazení dat tabulky používá ovládací prvek ComplexDataGridView .

Spuštění aplikace

Stisknutím klávesy F5 spusťte aplikaci.

Další kroky

V závislosti na požadavcích vaší aplikace můžete po vytvoření ovládacího prvku, který podporuje datovou vazbu, provést několik kroků. Mezi typické další kroky patří:

• Umístění vlastních ovládacích prvků do knihovny ovládacích prvků, abyste je mohli znovu použít v jiných aplikacích.

• Vytváření ovládacích prvků, které podporují scénáře vyhledávání Další informace najdete v tématu Vytvoření model Windows Forms uživatelského ovládacího prvku, který podporuje vazbu vyhledávacích dat.

Související obsah

• Vytvoření vazby ovládacích prvků modelu Windows Forms k datům v sadě Visual Studio
• Nastavení ovládacího prvku, který má být vytvořen při přetažení z okna zdrojů dat
• Windows Forms – ovládací prvky