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

  • Článek

Při zobrazení dat na Windows Forms, můžete zvolit existující ovládací prvky z panelu nástrojů nebo můžete vytvářet vlastní ovládací prvky, pokud vaše aplikace vyžaduje funkce není k dispozici ve standardních ovládacích prvků.Tento průvodce ukazuje, jak vytvořit ovládací prvek, který implementuje LookupBindingPropertiesAttribute.Určuje, které implementují LookupBindingPropertiesAttribute může obsahovat tři vlastnosti, které mohou být vázána k datům.Tyto prvky jsou podobné ComboBox.

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í ve scénářích vázání je nutné implementovat jedno z následujících vázání atributů:

Použití atributu datové vazby

Implementovat DefaultBindingPropertyAttribute na jednoduché ovládací prvky, jako TextBox, který jeden sloupec (nebo vlastnost) dat zobrazit.Další informace naleznete v tématu Návod: Vytvoření uživatelského ovládacího prvku Windows Forms, který podporuje jednoduchou datovou vazbu.

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.(Tento proces je popsán v tuto stránku průvodce.)

Tento průvodce vytvoří ovládacího prvku pro vyhledávání, která se sváže s daty ze dvou tabulek.V tomto příkladu Customers a Orders tabulek z ukázkové databáze Northwind.Vyhledávací ovládací prvek bude vázán k CustomerID pole z Orders tabulky.Tato hodnota se bude používat k vyhledání CompanyName z Customers tabulky.

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 LookupBindingProperty atributu.

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

  • Nastavte ID zákazníka sloupec na objednávky tabulky v zdroje dat okna používat nový ovládací prvek.

  • 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. Pojmenujte tento projekt LookupControlWalkthrough.

  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.

    LookupControlWalkthrough 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ří ovládací prvek pro vyhledávání z uživatelský ovládací prvek, takže přidejte uživatelský ovládací prvek položku LookupControlWalkthrough projektu.

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

  1. Z projektu klepněte na příkaz Přidat uživatelský ovládací prvek.

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

    LookupBox 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 LookupBox

Chcete-li navrhnout LookupBox ovládacího prvku

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

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

Pro vyhledávání ovládací prvky tohoto podpory datové vazby, můžete implementovat LookupBindingPropertiesAttribute.

Implementace atributu LookupBindingProperties

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

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

    <System.ComponentModel.LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "LookupMember")>
Public Class LookupBox

    Public Property DataSource() As Object 
        Get 
            Return ComboBox1.DataSource
        End Get 
        Set(ByVal value As Object)
            ComboBox1.DataSource = value
        End Set 
    End Property 

    Public Property DisplayMember() As String 
        Get 
            Return ComboBox1.DisplayMember
        End Get 
        Set(ByVal value As String)
            ComboBox1.DisplayMember = value
        End Set 
    End Property 

    Public Property ValueMember() As String 
        Get 
            Return ComboBox1.ValueMember
        End Get 
        Set(ByVal value As String)
            ComboBox1.ValueMember = value
        End Set 
    End Property 

    Public Property LookupMember() As String 
        Get 
            Return ComboBox1.SelectedValue.ToString()
        End Get 
        Set(ByVal value As String)
            ComboBox1.SelectedValue = value
        End Set 
    End Property 
End Class

    using System.Windows.Forms;

namespace CS
{
    [System.ComponentModel.LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "LookupMember")]
    public partial class LookupBox : UserControl
    {
        public object DataSource
        {
            get{ return comboBox1.DataSource; }
            set{ comboBox1.DataSource = value; }
        }

        public string DisplayMember
        {
            get{ return comboBox1.DisplayMember; }
            set{ comboBox1.DisplayMember = value; }
        }

        public string ValueMember
        {
            get{ return comboBox1.ValueMember; }
            set{ comboBox1.ValueMember = value; }
        }

        public string LookupMember
        {
            get{ return comboBox1.SelectedValue.ToString(); }
            set{ comboBox1.SelectedValue = value; }
        }


        public LookupBox()
        {
            InitializeComponent();
        }
    }
}

  3. V nabídce Sestavení vyberte příkaz Řešení sestavení.

Vytvoření zdroje dat z databáze

Tento krok vytvoří zdroj dat pomocí Průvodce konfigurací zdroje dat na základě Customers a Orders tabulky v databázi Northwind ukázky.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í.

Chcete-li vytvořit zdroj 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í ke spuštění Přidat či upravit připojení dialogového okna.

  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 a Orders tabulky a potom klikněte na tlačítko Dokončit.

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

Nastavení ID zákazníka sloupce z tabulky objednávky použití ovládacího prvku LookupBox

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 ID zákazníka k vytvoření vazby k ovládacímu prvku LookupBox

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

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

  3. Rozbalit objednávky uzlu (v Zákazníci uzel níže Fax sloupec).

  4. Klepněte na rozevírací šipku na objednávky uzel a zvolte možnost Podrobnosti ze seznamu řízení.

  5. Klepněte na rozevírací šipku na ID zákazníka sloupce (v objednávky uzel) a zvolte možnost Vlastní.

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

  7. Klikněte na tlačítko OK.

  8. Klepněte na rozevírací šipku na ID zákazníka sloupce a zvolte možnost LookupBox.

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 okna do Form1.

Chcete-li vytvořit ovládací prvky vázání dat ve formuláři systému Windows

  • Přetáhněte objednávky uzlu z zdroje dat window do formuláře systému Windows a ověřte, zda LookupBox ovládací prvek slouží k zobrazení dat v CustomerID sloupec.

Vazbu ovládacího prvku k vyhledání názvu název společnosti z tabulky Zákazníci

Chcete-li nastavit vazby vyhledávání

Spuštění aplikace

Spuštění aplikace

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

  • Procházet některé záznamy a ověřte, zda CompanyName se zobrazí v LookupBox ovládacího prvku.

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řipojení k datům v sadě Visual Studio