Sdílet prostřednictvím

Názorný postup: Vytvoření ovládacího prvku model Windows Forms uživatelských dat podporuje jednoduché vazby

  • Článek

Při zobrazení dat ve formulářích v aplikacích systému Windows, můžete zvolit z existujících prvků panel, nebo pokud aplikace vyžaduje funkčnost, která není k dispozici ve standardních ovládacích prvků, můžete vytvářet vlastní ovládací prvky.Tento názorný postup ukazuje, jak vytvořit ovládací prvek, který implementuje DefaultBindingPropertyAttribute.Určuje, že implementace 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 Vývoj model Windows Forms ovládací prvky v době návrhu.

Vytváření ovládacích prvků pro použití v situacích vázání dat, je třeba provést jednu z následujících atributů datové vazby:

Použití atributu vázání

Implementace DefaultBindingPropertyAttribute v jednoduchých ovládacích prvcích, jako TextBox, jeden sloupec (nebo vlastnost) dat, zobrazit.(Tento proces je popsán v této stránce názorný postup).

Implementace ComplexBindingPropertiesAttribute na ovládací prvky, jako DataGridView, který zobrazit seznamy nebo tabulky dat.Další informace naleznete v tématu Názorný postup: Vytvoření ovládacího prvku model Windows Forms uživatele podporuje komplexní Data vazba.

Implementace LookupBindingPropertiesAttribute na ovládací prvky, jako ComboBox, která zobrazit seznamy nebo tabulky dat, ale také potřeba jednoho sloupce nebo vlastnost.Další informace naleznete v tématu Názorný postup: Vytvoření ovládacího prvku model Windows Forms uživatele že vázání podporuje vyhledávání.

Tento návod se 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í telefonní čísla zákazníka ve standardním formátu telefonního čísla pomocí MaskedTextBox a nastavení masky na telefonní číslo.

Během tohoto návodu se naučíte, jak:

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

  • Přidat nový Uživatelský ovládací prvek do projektu.

  • Vizuálně navrhněte uživatelský ovládací prvek.

  • Implementace DefaultBindingProperty atributu.

  • Vytvořit objekt dataset s Průvodce konfigurací zdroje dat.

  • Nastavit telefonní ve sloupci Zdroje dat okno používat nový ovládací prvek.

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

Požadavky

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

Vytvoření aplikace pro Windows

Prvním krokem je vytvoření Aplikace systému Windows.

Vytvořit nový projekt systému Windows

  1. V aplikaci Visual Studio z soubor nabídce vytvořit nový projektu.

  2. Název projektu SimpleControlWalkthrough.

  3. Vyberte Aplikace systému Windows a na OK.Další informace naleznete v tématu Tvorba klientských aplikací.

    SimpleControlWalkthrough projektu je vytvořena a přidána do Aplikaci Solution Explorer.

Přidávání uživatelských ovládacích do projektu

Tento názorný postup vytvoří jednoduchý data vazbu ovládacího prvku z Řízení uživatelských, tak přidat Řízení uživatelských položka na SimpleControlWalkthrough projektu.

Přidat ovládací prvek uživatele k projektu

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

  2. Typ PhoneNumberBox v oblasti název a klepněte na Přidat.

    PhoneNumberBox ovládacího prvku je přidán do Aplikaci Solution Explorer a otevře v návrháři.

Vytvoření ovládacího prvku PhoneNumberBox

Tento názorný postup rozšiřuje stávající MaskedTextBox vytvořit PhoneNumberBox řízení.

PhoneNumberBox ovládací prvek návrhu

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

  2. Vyberte na inteligentní značku MaskedTextBox stačí přetáhnout a zvolte Nastavit masku.

  3. Vyberte telefonní číslo v Vstupní maska dialogovém okně a klepněte na OK nastavit masku.

Přidáním požadovaného atributu vázání dat

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

Atribut DefaultBindingProperty implementace

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

  2. Nahradit kód PhoneNumberBox s následujícím:

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

Vytváření zdroje dat z databáze

Tento krok se používá Průvodce konfigurací zdroje dat vytvořit zdroj dat založený na Customers tabulky v ukázkové databázi Northwind.Musí mít přístup k vytvoření připojení ukázkové databáze Northwind.Informace o nastavení ukázkové databáze Northwind, viz Jak: Instalace ukázkové databáze.

Vytvořit zdroj dat

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

  2. V Zdroje dat vyberte Přidat nový zdroj dat spustit Průvodce konfigurací zdroje dat.

  3. Vyberte Databázi na stránce Zvolit datový typ zdrojová databáze a potom klikněte na tlačítko Next.

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

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

      Nebo

    • Vyberte Nové připojení spustit Přidat nebo změnit připojení dialogové okno.Další informace naleznete v tématu Přidat či upravte dialogové okno připojení (Obecné).

  5. Pokud databáze vyžaduje heslo, vyberte možnost obsahují citlivá data a klepněte na tlačítko Další.

  6. Klepněte na tlačítko Další na Uložit řetězec připojení v souboru konfigurace aplikace stránku.

  7. Rozbalte tabulek uzel zvolit databázové objekty stránky.

  8. Vyberte Customers tabulka a potom klepněte na tlačítko Dokončit.

    NorthwindDataSet je do projektu a Customers tabulka Zdroje dat okna.

Nastavení telefonu sloupec použít ovládací PhoneNumberBox

V rámci Zdroje dat okna můžete nastavit před přetažením položky na formuláři vytvořit ovládací prvek.

Nastavit sloupec Telefon svázat ovládací prvek PhoneNumberBox

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

  2. Rozbalte Zákazníci v uzlu Zdroje dat okna.

  3. Klepněte na šipku dolů Zákazníci uzlu a zvolte Podrobnosti ze seznamu řízení.

  4. Klepněte na šipku dolů telefonní sloupce a vyberte vlastní.

  5. Vyberte PhoneNumberBox ze seznamu Související ovládací prvky v Dat možnosti přizpůsobení uživatelského rozhraní dialogové okno.

  6. Klepněte na šipku dolů telefonní sloupce a vyberte PhoneNumberBox.

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

Ovládací prvky vázané na data můžete vytvořit přetažením položky 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 řízení slouží k zobrazení dat v Phone sloupce.

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

Spuštění aplikace

Spuštění aplikace

  • Stisknutím klávesy F5 spustíte aplikaci.

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 vázání dat podporuje.Některé typické krokům patří:

Viz také

Úkoly

Jak: nastavení řízení má být vytvořen při přetažení z okno zdroje dat

Koncepty

Vazba na Data v aplikaci Visual Studio model Windows Forms prvky

Příprava aplikace pro příjem dat.

Načítání dat do aplikace

Ovládací prvky vazby na Data v aplikaci Visual Studio

Data v aplikaci pro úpravy

Ověření dat

Ukládání dat

Další zdroje

Přehled dat aplikace Visual Studio

Připojení k datům v aplikaci Visual Studio