Instruktaż: Tworzenie formantu użytkownika Windows Forms obsługuje dane proste powiązanie

Artykuł
02/27/2013

Wyświetlanie danych w formularzach w aplikacji systemu Windows, można wybrać istniejące formanty z Przybornik, lub jeśli aplikacja wymaga funkcji, które są dostępne w standardowych formantów, mogą tworzyć niestandardowe formanty.W tym instruktażu pokazano, jak utworzyć formant, który implementuje DefaultBindingPropertyAttribute.Kontroluje, że wdrożenie DefaultBindingPropertyAttribute może zawierać jedną właściwość powiązaną danych.Takie kontrole są podobne do TextBox lub CheckBox.

Więcej informacji dotyczących tworzenia sterowania, zobacz Programowanie formantów Windows Forms w czasie projektowania.

Tworzenia formantów do użycia w scenariuszach powiązanie danych, należy zaimplementować jeden z następujących atrybutów powiązania danych:

Użycie atrybutu DataBinding
Wdrożenie DefaultBindingPropertyAttribute na proste formanty, jak TextBox, że wyświetlanie pojedynczej kolumny (lub właściwość) danych.(Ten proces jest opisany w tym instruktażu strony).
Wdrożenie ComplexBindingPropertiesAttribute na formanty, jak DataGridView, że wyświetlanie list (lub tabele) danych.Aby uzyskać więcej informacji, zobacz Instruktaż: Tworzenie formantu użytkownika Windows Forms tego powiązania obsługuje złożonych danych.
Wdrożenie LookupBindingPropertiesAttribute na formanty, jak ComboBox, że wyświetlanie list (lub tabele) danych, ale muszą stanowić pojedyncza kolumna lub właściwości.Aby uzyskać więcej informacji, zobacz Instruktaż: Tworzenie formantu użytkownika Windows Forms tego wiązania danych obsługuje wyszukiwania.

Instruktaż ten tworzy prosty formant, który wyświetla dane z pojedynczej kolumny w tabeli.W tym przykładzie Phone kolumny Customers tabeli z bazy danych Northwind.Kontrola proste użytkownika będą wyświetlane numery telefonów odbiorcy w standardowym formacie numer telefonu przy użyciu MaskedTextBox i ustawienie maski na numer telefonu.

W tym instruktażu przedstawiono sposób:

Utwórz nowy Aplikacji Windows.
Dodaj nowy Formantu użytkownika do projektu.
Wizualne projektowanie kontroli użytkownika.
Wdrożenie DefaultBindingProperty atrybut.
Tworzenie zestawu danych z Kreator konfiguracji źródła danych.
Ustaw Telefon kolumny w Źródeł danych okno, aby użyć nowego formantu.
Utwórz formularz do wyświetlania danych w nowym formantem.

Wymagania wstępne

W celu przeprowadzenia tego instruktażu będą potrzebne:

Dostęp do przykładowej bazy danych Northwind.Aby uzyskać więcej informacji, zobacz Jak: Instalowanie przykładowe bazy danych.

Tworzenie aplikacji systemu Windows

Pierwszym krokiem jest utworzenie Aplikacji Windows.

Aby utworzyć nowy projekt systemu Windows

W programie Visual Studio z pliku menu Utwórz nowy projektu.
Nazwa projektu SimpleControlWalkthrough.
Wybierz Aplikacji Windows i kliknij przycisk OK.Aby uzyskać więcej informacji, zobacz Tworzenie aplikacji klienta.

SimpleControlWalkthrough projektu jest tworzony i dodawany do Solution Explorer.

Dodawanie formantu użytkownika do projektu

Instruktaż ten tworzy proste, które można powiązać dane formantu z Formantu użytkownika, dodać tak Formantu użytkownika element do SimpleControlWalkthrough projektu.

Aby dodać formant użytkownika do projektu

Z projektu menu wybierz Dodaj formant użytkownika.
Typ PhoneNumberBox w obszarze Nazwa, a następnie kliknij Dodaj.

PhoneNumberBox kontroli jest dodawany do Solution Explorer i otwiera projektanta.

Projektowania formantu PhoneNumberBox

W tym instruktażu rozszerza istniejące MaskedTextBox do tworzenia PhoneNumberBox kontroli.

Aby zaprojektować formant PhoneNumberBox

Przeciągnij MaskedTextBox z Przybornik na powierzchnię projektu kontroli użytkownika.
Wybierz tag inteligentny, na MaskedTextBox po prostu przeciągany i wybierz polecenie Ustawić maskę.
Wybierz numer telefonu w Maska wprowadzania okno dialogowe i kliknij przycisk OK ustawić maskę.

Dodawanie wymaganego atrybutu powiązanie danych

Proste formantów databinding tej obsługi, zaimplementować DefaultBindingPropertyAttribute.

Aby zaimplementować atrybutu DefaultBindingProperty

Przełącznik PhoneNumberBox formantu do widoku Kod.(Na widoku menu wybierz kodu.)

Zastąp kod w PhoneNumberBox z następujących czynności:

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

Z budować menu wybierz Roztwór budować.

Tworzenie źródła danych z bazy danych

Krok ten używa Kreatora konfiguracji źródła danych utworzyć źródło danych na podstawie Customers tabeli w bazie danych Northwind.Musi mieć dostęp do przykładowej bazy danych Northwind do utworzenia połączenia.Informacje na temat konfigurowania przykładowej bazy danych Northwind, zobacz Jak: Instalowanie przykładowe bazy danych.

Aby utworzyć źródło danych

Na dane menu, kliknij Pokaż źródeł danych.
W Źródeł danych okno select Dodać nowe źródło danych uruchomić Kreatora konfiguracji źródła danych.
Wybierz bazy danych na Wybierz typ źródła danych strony, a następnie kliknij Dalej.
Na Wybierz połączenie danych do strony, jedną z następujących czynności:
- Jeśli połączenie danych z przykładowej bazy danych Northwind jest dostępna na liście rozwijanej, zaznacz go.
  
  Lub
- Wybierz Nowe połączenie uruchomić Dodawanie i modyfikowanie połączenia okno dialogowe.Aby uzyskać więcej informacji, zobacz Dodawanie/modyfikowanie połączeń, okno dialogowe (Ogólne).
Jeśli baza danych wymaga podania hasła, zaznacz opcję zawierają dane poufne, a następnie kliknij przycisk Dalej.
Kliknij Dalej na zapisać ciąg połączenia w pliku konfiguracyjnym aplikacji strony.
Rozwiń tabel węzeł na Wybierz obiekty bazy danych strony.
Wybierz Customers tabeli, a następnie kliknij Zakończ.

NorthwindDataSet jest dodawany do projektu i Customers tabela pojawi się w Źródeł danych okna.

Ustawienie kolumny telefonu, aby użyć formantu PhoneNumberBox

W Źródeł danych okna, można ustawić kontrolę przed przeciąganie elementów formularza.

Aby ustawić kolumny telefonu powiązać formant PhoneNumberBox

Otwórz Form1 w projektancie.
Rozwiń Klienci węzeł w Źródeł danych okna.
Kliknij strzałkę rozwijania w Klienci węzła i wybierz polecenie Szczegóły z listy kontroli.
Kliknij strzałkę rozwijania w Telefon kolumny i wybierz polecenie Dostosuj.
Wybierz PhoneNumberBox z listy Związane formanty w Opcje dostosowywania interfejsu użytkownika danych okno dialogowe.
Kliknij strzałkę rozwijania w Telefon kolumny i wybierz polecenie PhoneNumberBox.

Dodawanie formantów do formularza

Formanty powiązane z danymi można utworzyć, przeciągając elementy z Źródeł danych okno formularza.

Aby utworzyć formanty powiązane z danymi formularza

Przeciągnij głównym Klienci węzła z Źródeł danych okno formularza i sprawdź, czy PhoneNumberBox formantu służy do wyświetlania danych w Phone kolumny.

Formanty powiązane dane opisowe etykiety są wyświetlane w formularzu oraz pasek narzędzi (BindingNavigator) do nawigowania między rekordami.A NorthwindDataSet, CustomersTableAdapter, BindingSource, i BindingNavigator na liście komponentów.

Uruchamiania aplikacji

Aby uruchomić aplikację

Naciśnij klawisz F5, aby uruchomić aplikację.

Następne kroki

W zależności od wymagań aplikacji istnieje kilka czynności, które chcesz wykonać po utworzenie formantu obsługuje wiązania danych.Niektóre typowe następne kroki obejmują:

Wprowadzania niestandardowych formantów w bibliotece sterowania tak można wykorzystać w innych aplikacjach.
Tworzenie formantów, które obsługują bardziej złożonych scenariuszy wiązania danych.Aby uzyskać więcej informacji, zobacz Instruktaż: Tworzenie formantu użytkownika Windows Forms tego powiązania obsługuje złożonych danych i Instruktaż: Tworzenie formantu użytkownika Windows Forms tego wiązania danych obsługuje wyszukiwania.

Zobacz też

Udostępnij za pośrednictwem