Vytvoření uživatelského ovládacího prvku Windows Forms, který podporuje jednoduchou datovou vazbu

 

Publikováno: duben 2016

Při zobrazení dat ve formulářích v aplikacích Windows, můžete zvolit existující ovládací prvky z nástrojů, nebo můžete vytvářet vlastní ovládací prvky, pokud aplikace vyžaduje funkci, která není k dispozici v standardní ovládací prvky. Tento návod ukazuje, jak vytvořit ovládací prvek, který implementuje DefaultBindingPropertyAttribute. Ovládací prvky, které implementují DefaultBindingPropertyAttribute může obsahovat jednu vlastnost, která mohou být vázány na data. Tyto prvky jsou podobné TextBox nebo CheckBox.

Další informace o vytváření ovládacího prvku, naleznete v části Vývoj ovládacích prvků Windows Forms v době návrhu.

Při vytváření ovládacích prvků pro použití v scénáře datových vazeb, musíte implementovat jednu z následujících atributů vázání dat:

Použití atributu datové vazby
Implementace DefaultBindingPropertyAttribute na jednoduché ovládací prvky, stejně jako TextBox, který zobrazit jeden sloupec (nebo vlastnost) dat. (Tento proces je popsán v této stránce návod).
Implementace ComplexBindingPropertiesAttribute na ovládací prvky, stejně jako DataGridView, který zobrazit seznamy (nebo tabulky) data. Další informace naleznete v tématu Vytvoření uživatelského ovládacího prvku Windows Forms, který podporuje rozšířené datové vazby.
Implementace LookupBindingPropertiesAttribute na ovládací prvky, stejně jako ComboBox, který zobrazení seznamy (nebo tabulky) dat, ale také musí představovat jeden sloupec nebo vlastnost. Další informace naleznete v tématu Vytvoření uživatelského ovládacího prvku Windows Forms, který podporuje datovou vazbu vyhledávání.

Tento návod vytvoří jednoduchý ovládací prvek zobrazující data z jednoho sloupce v tabulce. Tento příklad používá Phone sloupec Customers tabulku z ukázkové databázi Northwind. Jednoduchý uživatelský ovládací prvek se zobrazí telefonní čísla zákazníka ve standardním formátu telefonní číslo pomocí MaskedTextBox a nastavení masky na telefonní číslo.

V tomto návodu se dozvíte, jak:

• Vytvořit nový aplikace Windows.

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

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

• Implementace DefaultBindingProperty atributu.

• Vytvoření datové sady pomocí Průvodce konfigurací zdroje dat.

• Nastavte Phone sloupec v zdroje dat okno používat nový ovládací prvek.

• Vytvořte formulář k zobrazení dat v nového ovládacího prvku.

Požadavky

K dokončení tohoto návodu, budete potřebovat:

• Přístup k ukázkové databázi Northwind. Další informace naleznete v tématu Postupy: Instalace ukázkových databází.

Vytvoření aplikace pro Windows

Prvním krokem je vytvoření aplikace Windows.

Vytvoření nového projektu Windows

1. V sadě Visual Studio z soubor nabídky, vytvořte novou projektu.

2. Název projektu SimpleControlWalkthrough.

3. Vyberte aplikace Windows a klikněte na tlačítko OK. Další informace naleznete v tématu Klientské aplikace.

   SimpleControlWalkthrough je vytvořen a přidán do projektu Průzkumníku řešení.

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

Tento návod vytvoří jednoduchý s možností datové vazby ovládacího prvku z uživatelský ovládací prvek, takže přidejte uživatelský ovládací prvek položku SimpleControlWalkthrough projektu.

Chcete-li přidat uživatelský ovládací prvek do projektu

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

2. Typ PhoneNumberBox název oblasti a klikněte na tlačítko Přidat.

   PhoneNumberBox ovládací prvek je přidán do Průzkumníku řešení a otevře v návrháři.

Návrh PhoneNumberBox ovládacího prvku

Tento návod se rozbalí na stávajících MaskedTextBox vytvořit PhoneNumberBox ovládacího prvku.

Chcete-li navrhnout PhoneNumberBox ovládacího prvku

1. Přetáhněte MaskedTextBox z nástrojů na plochu návrhu uživatelského ovládacího prvku.

2. Vyberte inteligentní značky na MaskedTextBox právě přetáhli a zvolte nastavit maska.

3. Vyberte telefonní číslo v Vstupní maska dialogové okno a klikněte na tlačítko OK k nastavení masky.

Přidání požadovaný atribut datová vazba

Pro jednoduché ovládací prvky který podporu datovou vazbu, implementovat DefaultBindingPropertyAttribute.

K implementaci atributu DefaultBindingProperty

1. Přepínač PhoneNumberBox ovládacího prvku k zobrazení kódu. (Na zobrazení nabídce zvolte kódu.)

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

   using System.Windows.Forms;
   
   namespace CS
   {
       [System.ComponentModel.DefaultBindingProperty("PhoneNumber")]
       public partial class PhoneNumberBox : UserControl
       {
           public string PhoneNumber
           {
               get{ return maskedTextBox1.Text; }
               set{ maskedTextBox1.Text = value; }
           }
   
           public PhoneNumberBox()
           {
               InitializeComponent();
           }
       }
   }
   

   <System.ComponentModel.DefaultBindingProperty("PhoneNumber")>
   Public Class PhoneNumberBox
   
       Public Property PhoneNumber() As String
           Get
               Return MaskedTextBox1.Text
           End Get
           Set(ByVal value As String)
               MaskedTextBox1.Text = value
           End Set
       End Property
   End Class
   

3. Z sestavení nabídce zvolte Sestavit řešení.

Vytváření zdroje dat z databáze

Tento krok používá Průvodce konfigurací zdroje dat vytvořit zdroj dat na základě Customers tabulky v ukázkové databázi Northwind. Musí mít přístup k ukázkové databázi Northwind k vytvoření připojení. Informace o nastavení ukázkové databázi Northwind naleznete v tématu Postupy: Instalace ukázkových databází.

Vytvoření zdroje dat

1. Na Data nabídky, klikněte na tlačítko Zobrazit zdroje dat.

2. V zdroje dat vyberte Přidat nový zdroj dat ke spuštění Průvodce konfigurací zdroje dat.

3. Vyberte databáze na Zvolte typ zdroje dat a potom klikněte na tlačítko Další.

4. Na Vybrat datové připojení proveďte jednu z následujících akcí:

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

     Nebo

   • Vyberte nové připojení ke spuštění Přidat nebo upravit připojení dialogové okno.

5. Pokud vaše databáze vyžaduje heslo, vyberte možnost zahrnout citlivá data, a potom klikněte na tlačítko Další.

6. Klikněte na tlačítko Další na Uložit připojovací řetězec do konfiguračního souboru aplikace stránky.

7. Rozbalte tabulky uzel na Zvolte vaše databázové objekty stránky.

8. Vyberte Customers tabulce a pak klikněte na tlačítko Dokončit.

   NorthwindDataSet je přidán do projektu a Customers tabulky se zobrazí v zdroje dat okna.

Nastavení sloupec Telefon použití ovládacího prvku PhoneNumberBox

V rámci zdroje dat okno můžete nastavit ovládací prvek, který má být vytvořen před přetažení položek do formuláře.

Chcete-li nastavit sloupec Telefon vytvořit vazbu k ovládacímu prvku PhoneNumberBox

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

2. Rozbalte Zákazníci uzel v zdroje dat okna.

3. Klikněte na šipku rozevíracího seznamu Zákazníci uzel a zvolte Podrobnosti ze seznamu ovládacího prvku.

4. Klikněte na šipku rozevíracího seznamu Phone sloupce a klikněte na tlačítko Přizpůsobit.

5. Vyberte PhoneNumberBox ze seznamu přidružené ovládací prvky v Možnosti přizpůsobení uživatelského rozhraní dat dialogové okno.

6. Klikněte na šipku rozevíracího seznamu Phone sloupce a klikněte na tlačítko PhoneNumberBox.

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

Můžete vytvořit ovládací prvky vázané na data přetažením položek z zdroje dat okna do formuláře.

Chcete-li vytvořit ovládací prvky vázané na data ve formuláři

• Přetáhněte hlavní Zákazníci uzlu z zdroje dat okna do formuláře a ověřte, zda PhoneNumberBox ovládací prvek slouží k zobrazení dat v Phone sloupce.

  Ovládací prvky vázané na data s popisky se zobrazí ve formuláři spolu s pruhem nástrojů (BindingNavigator) pro procházení záznamů. A NorthwindDataSet, CustomersTableAdapter, BindingSource, a BindingNavigator v panelu komponent se zobrazí.

Spuštění aplikace

Ke spuštění aplikace

• Stisknutím klávesy F5 ke spuštění aplikace.

Další kroky

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

• Umístění vlastních ovládacích prvků do knihovny ovládacích prvků tak znovu využít v jiných aplikací.

• Vytváření ovládacích prvků, které podporují složitější scénáře datových vazeb. Další informace naleznete v tématu Vytvoření uživatelského ovládacího prvku Windows Forms, který podporuje rozšířené datové vazby a Vytvoření uživatelského ovládacího prvku Windows Forms, který podporuje datovou vazbu vyhledávání.

Viz také

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