Sdílet prostřednictvím

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

  • Článek

Při zobrazení dat ve formulářích v aplikacích systému Windows, můžete zvolit existující ovládací prvky z nástrojů, nebo můžete vytvářet vlastní ovládací prvky, pokud vaše aplikace vyžaduje funkci, která není k dispozici v standardní ovládací prvky.Tento průvodce ukazuje, jak vytvořit ovládací prvek, který implementuje DefaultBindingPropertyAttribute.Určuje, které implementují DefaultBindingPropertyAttribute může obsahovat jednu vlastnost, která může být vázána k datům.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í prvky pro použití ve scénářích vazby dat, je nutné implementovat jedno z následujících atributů vazby dat:

Použití atributu datové vazby

Implementovat DefaultBindingPropertyAttribute na jednoduché ovládací prvky, jako TextBox, který jeden sloupec (nebo vlastnost) dat zobrazit.(Tento proces je popsán v tuto stránku průvodce.)

Implementovat ComplexBindingPropertiesAttribute na ovládací prvky, jako DataGridView, který zobrazení dat seznamů (nebo tabulky).Další informace naleznete v tématu Návod: Vytvoření uživatelského ovládacího prvku Windows Forms, který podporuje rozšířené datové vazby.

Implementovat LookupBindingPropertiesAttribute na ovládací prvky, jako je ComboBox, který zobrazení dat seznamů (nebo tabulky), ale také musí představovat jeden sloupec nebo vlastnost.Další informace naleznete v tématu Návod: Vytvoření uživatelského ovládacího prvku Windows Forms, který podporuje datovou vazbu vyhledání.

Tento průvodce vytvoří jednoduchý ovládací prvek, který zobrazuje data z jednoho sloupce v tabulce.V tomto příkladu Phone sloupec Customers tabulky z ukázkové databáze Northwind.Jednoduchý uživatelský ovládací prvek zobrazí zákazníka telefonní čísla ve standardním formátu telefonní číslo s použitím MaskedTextBox a nastavení maska na telefonní číslo.

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

  • Vytvořte novou aplikace pro systém Windows.

  • Přidat novou uživatelský ovládací prvek do svého projektu.

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

  • Implementace DefaultBindingProperty atributu.

  • Vytvořit datovou sadu s Průvodce konfigurací zdroje dat.

  • Nastavte Telefonní sloupec v zdroje dat okna použití nového ovládacího prvku.

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

Požadavky

K dokončení tohoto průvodce, budete potřebovat:

Vytvoření aplikace pro Windows

Prvním krokem je vytvoření aplikace pro systém 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 pro systém Windows a klikněte na tlačítko OK.Další informace naleznete v tématu Vývoj klientských aplikací s použitím rozhraní .NET Framework.

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

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

Tento průvodce vytvoří jednoduchý ovládací prvek vázat na data 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íka řešení a otevře v návrháři.

Vytvoření ovládacího prvku PhoneNumberBox

V tomto návodu se rozbalí na stávajících MaskedTextBox Chcete-li 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čku na MaskedTextBox stačí přetáhli a zvolte nastavit maska.

  3. Vyberte telefonní číslo v Vstupní maska dialogové okno a klikněte na tlačítko OK Chcete-li nastavit masku.

Přidání požadovaný atribut vazby dat

Pro jednoduché ovládací prvky vázání této podpory, implementovat DefaultBindingPropertyAttribute.

Implementace atributu DefaultBindingProperty

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

  2. Nahraďte kód ve PhoneNumberBox s následující:

    <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

    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();
        }
    }
}

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

Vytvoř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íte mít přístup k ukázkové databázi Northwind pro vytvoření připojení.Informace o nastavení ukázkové databáze Northwind naleznete v tématu Postupy: Instalace ukázkových databází.

Vytvoření zdroje dat

  1. V nabídce Data klikněte na tlačítko Zobrazit zdroje dat.

  2. V okně Zdroje dat výběrem možnosti Přidat nový zdroj dat spusťte Průvodce konfigurací zdroje dat.

  3. Vyberte možnost Databáze na stránce Zvolit typ datového zdroje a potom klikněte na tlačítko Další.

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

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

      Nebo

    • Vyberte Nové připojení k zobrazení dialogového okna Přidat nebo upravit připojení.

  5. Pokud vaše databáze vyžaduje heslo, vyberte možnost k zahrnutí důvěrných osobních údajů a pak klikněte na tlačítko Další.

  6. Klepněte na tlačítko Next na stránce Uložit připojovací řetězec do konfiguračního souboru aplikace.

  7. Rozbalte uzel Tabulky na stránce Zvolte vaše databázové objekty.

  8. Vyberte Customers tabulky a potom 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 Phone 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ím položek do formuláře.

Chcete-li nastavit sloupec Telefon pro vytvoření vazby k ovládacímu prvku PhoneNumberBox

  1. Otevřít Form1 v návrháři.

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

  3. Klepněte na rozevírací šipku na Zákazníci uzel a zvolte možnost Podrobnosti ze seznamu řízení.

  4. Klepněte na rozevírací šipku na Telefon sloupce a zvolte možnost Vlastní.

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

  6. Klepněte na rozevírací šipku na Telefon sloupce a zvolte možnost PhoneNumberBox.

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

Můžete vytvořit ovládací prvky vázání dat přetažením položek z zdroje dat window do formuláře.

Vytvoření ovládacích prvků vázaných na data ve formuláři

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

    Ve formuláři, spolu s pruh nástrojů jsou zobrazeny vázaného na data ovládací prvky s popisky (BindingNavigator) pro procházení záznamů.Objekt NorthwindDataSet, CustomersTableAdapter, BindingSource, a BindingNavigator se zobrazí na hlavním panelu součásti.

Spuštění aplikace

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 zahrnují:

Viz také

Úkoly

Postupy: Nastavení ovládacího prvku, který má být vytvořen při přetažení z okna zdrojů dat

Koncepty

Vázání ovládacích prvků Windows Forms k datům v sadě Visual Studio

Příprava vaší aplikace k příjmu dat

Načítání dat do vaší aplikace

Vázání ovládacích prvků k datům v sadě Visual Studio

Upravování dat ve vaší aplikaci

Ověřování dat

Ukládání dat

Další zdroje

Přehled datových aplikacích v sadě Visual Studio

Připojení k datům v sadě Visual Studio