Sdílet prostřednictvím

Návod: Vytvoření uživatelského ovládacího prvku Windows Forms, který podporuje rozšířené datové vazby

  • Č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 ComplexBindingPropertiesAttribute.Určuje, které implementují ComplexBindingPropertiesAttribute obsahovat DataSource a DataMember Vlastnosti, které mohou být vázána k datům.Tyto prvky jsou podobné DataGridView nebo ListBox.

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 atributů vazby dat:

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

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ří komplexní ovládací prvek, který zobrazuje řádky dat z tabulky.V tomto příkladu Customers tabulky z ukázkové databáze Northwind.Komplexní uživatelský ovládací prvek zobrazí tabulku Zákazníci v DataGridView v ovládacím prvku vlastní.

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

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

  • Nastavte Zákazníci tabulky v Okno zdroje dat používat nové komplexního ovládacího prvku.

  • Přidat nový ovládací prvek přetažením z okno zdroje dat do Form1.

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

  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.

    ComplexControlWalkthrough 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

Vzhledem k tomu, že tento průvodce vytvoří komplexní ovládací prvek vázat na data z uživatelský ovládací prvek, je nutné přidat uživatelský ovládací prvek položky k 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. Zadejte ComplexDataGridView v název oblasti a potom klikněte na tlačítko Přidat.

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

Tento krok přidá DataGridView do uživatelského ovládacího prvku.

Chcete-li navrhnout ComplexDataGridView ovládacího prvku

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

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

Pro komplexní ovládací prvky na této vazby na data podpory, můžete implementovat ComplexBindingPropertiesAttribute.

Implementace atributu ComplexBindingProperties

  1. Přepnout ComplexDataGridView ovládacího prvku k zobrazení kódu.(Na zobrazení klepněte na příkaz kódu.)

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

    <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

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

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

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

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 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í tabulky Zákazníci použití ovládacího prvku ComplexDataGridView

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 tabulky Zákazníci k vytvoření vazby k ovládacímu prvku ComplexDataGridView

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

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

  5. Klepněte na rozevírací šipku na Customers tabulky a zvolte možnost ComplexDataGridView ze seznamu řízení.

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 okno 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 ComplexDataGridView ovládacího prvku se používá k zobrazení dat v tabulce.

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 vázání.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

Ovládací prvky Windows Forms

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