Sdílet prostřednictvím

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

  • Článek

 

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 ComplexBindingPropertiesAttribute. Ovládací prvky, které implementují ComplexBindingPropertiesAttribute obsahují DataSource a DataMember vlastnost, která mohou být vázány na data. 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 datové vazby je nutné 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. Další informace naleznete v tématu Vytvoření uživatelského ovládacího prvku Windows Forms, který podporuje jednoduchou datovou vazbu.
Implementace ComplexBindingPropertiesAttribute na ovládací prvky, stejně jako DataGridView, který zobrazit seznamy (nebo tabulky) data. (Tento proces je popsán v této stránce návod).
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ří komplexní ovládací prvek, který zobrazuje řádky dat z tabulky. Tento příklad používá Customers tabulku z ukázkové databázi Northwind. Komplexní uživatelského ovládacího prvku se zobrazí v tabulce Zákazníci v DataGridView ve vlastním ovládacím prvku.

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

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

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

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

Požadavky

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

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

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

    ComplexControlWalkthrough 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

Protože tento návod vytvoří komplexní s možností datové vazby ovládacího prvku 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. Typ ComplexDataGridView v název oblasti a pak klikněte na tlačítko Přidat.

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

Návrh ComplexDataGridView ovládacího prvku

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 datová vazba

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

K implementaci atributu ComplexBindingProperties

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

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

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

    <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. 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 Install SQL Server sample databases.

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í 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í položek do formuláře.

Chcete-li nastavit svázat s ovládacím prvkem ComplexDataGridView tabulky Zákazníci

  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 Přizpůsobit.

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

  5. Klikněte na šipku rozevíracího seznamu Customers tabulky a zvolte ComplexDataGridView ze seznamu ovládacího prvku.

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 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 ComplexDataGridView ovládací prvek slouží k zobrazení dat v tabulce.

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

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
Ovládací prvky Windows Forms