Wskazówki: tworzenie formantu użytkownika formularzy systemu Windows obsługującego proste powiązanie danych

Artykuł
06/10/2015

Podczas wyświetlania danych formularzy w aplikacji systemu Windows, można wybrać istniejące formantów z Przybornika, lub jeśli aplikacja wymaga funkcji, która nie jest dostępna w standardowych formantów, mogą tworzyć własne kontrolki.Niniejszy przewodnik pokazuje, jak utworzyć formant, który implementuje DefaultBindingPropertyAttribute.Określa, które implementują DefaultBindingPropertyAttribute może zawierać jedną właściwość może być powiązana z danymi.Takie formanty są podobne do TextBox lub CheckBox.

Aby uzyskać więcej informacji o kontroli, zobacz Opracowywanie formantów formularzy systemu Windows w czasie projektowania.

Formanty tworzenia pakietów administracyjnych do użycia w scenariuszach wiązanie danych, należy zaimplementować jedną z następujących atrybutów powiązania danych:

Użycie atrybutu wiązania danych
Wdrożenie DefaultBindingPropertyAttribute na proste formanty, takie jak TextBox, który pojedynczej kolumny (lub wyświetlić właściwości) danych.(Ten proces jest opisany na tej stronie Przewodnik).
Wdrożenie ComplexBindingPropertiesAttribute na formanty, takie jak DataGridView, który wyświetlania list lub tabel danych.Aby uzyskać więcej informacji, zobacz Wskazówki: tworzenie formantu użytkownika formularzy systemu Windows obsługującego złożone powiązanie danych.
Wdrożenie LookupBindingPropertiesAttribute na formanty, takie jak ComboBox, który wyświetlania list (lub tabele) danych, ale również wymagane do prezentowania kolumnę lub właściwości.Aby uzyskać więcej informacji, zobacz Wskazówki: tworzenie formantu użytkownika formularzy systemu Windows obsługującego powiązanie danych wyszukiwania.

Niniejszy przewodnik tworzy prosty formant, który wyświetla dane z jednej kolumny w tabeli.W tym przykładzie zastosowano Phone Kolumna Customers tabeli w bazie danych Northwind.Kontrola prosty użytkownika spowoduje wyświetlenie numerów telefonów odbiorcy w standardowym formacie numer telefonu przy użyciu MaskedTextBox i ustawienie maski na numer telefonu.

Podczas tej procedury pokażemy ci, jak:

Utwórz nowy aplikacji systemu Windows.
Dodaj nowy kontrolki użytkownika się z projektem.
Wizualne projektowanie kontrolki użytkownika.
Wdrożenie DefaultBindingProperty atrybutu.
Tworzenie zestawu danych z Kreator konfiguracji źródła danych.
Ustaw Phone kolumny w źródła danych okno, aby użyć nowego formantu.
Tworzenie formularza do wyświetlenia w formancie nowych danych.

Wymagania wstępne

Aby można było ukończyć tej procedury, należy mieć:

Dostęp do przykładowej bazy danych Northwind.Aby uzyskać więcej informacji, zobacz Porady: instalacja przykładowych baz danych.

Tworzenie aplikacji systemu Windows

Pierwszym krokiem jest utworzenie aplikacji systemu Windows.

Aby utworzyć nowy projekt systemu Windows

W programie Visual Studio z pliku menu, Utwórz nową projektu.
Nadaj nazwę projektowi SimpleControlWalkthrough.
Wybierz aplikacji systemu Windows i kliknij przycisk OK.Aby uzyskać więcej informacji, zobacz Wdrażanie aplikacji klienta za pomocą programu .NET Framework.

SimpleControlWalkthrough projektu zostało utworzone i dodane do Eksploratora rozwiązań.

Dodawanie kontrolki użytkownika do projektu

Niniejszy przewodnik tworzy prosty formant danych można powiązać z kontrolki użytkownika, więc dodać kontrolki użytkownika elementu do SimpleControlWalkthrough projektu.

Aby dodać kontrolki użytkownika do projektu

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

PhoneNumberBox formant zostanie dodany do Eksploratora rozwiązań i otwiera w projektancie.

Projektowania formantu PhoneNumberBox

Niniejszy przewodnik rozszerza istniejące MaskedTextBox można utworzyć PhoneNumberBox kontroli.

Aby projektować kontrolki PhoneNumberBox

Przeciągnij MaskedTextBox z Przybornika na powierzchnię projektową kontrolki użytkownika.
Wybierz tagu na MaskedTextBox po prostu przeciągnąć i wybrać ustawić maska.
Wybierz numer telefonu w Maska wprowadzania okno dialogowe i kliknij przycisk OK można ustawić maski.

Dodawanie wymaganego atrybutu powiązania danych

Prosty formantów tego wiązania danych pomocy technicznej, należy zaimplementować DefaultBindingPropertyAttribute.

Do zaimplementowania atrybutu DefaultBindingProperty

Przełącznik PhoneNumberBox kontroli do widoku Kod.(Na widoku menu, wybierz polecenie Kod.)

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 Tworzenie menu, wybierz polecenie tworzyć rozwiązania.

Tworzenie źródła danych z bazy danych

Ten krok używa Kreatora konfiguracji źródła danych Aby utworzyć źródło danych na podstawie Customers tabeli w bazie danych Northwind.Musisz mieć dostęp do przykładowej bazy danych Northwind do utworzenia połączenia.Aby uzyskać informacje o konfigurowaniu bazie danych Northwind, zobacz Porady: instalacja przykładowych baz danych.

Aby utworzyć źródło danych

W menu Dane kliknij przycisk Pokaż źródła danych.
W oknie Źródła danych wybierz Dodaj nowe źródło danych aby uruchomić Kreatora konfiguracji źródła danych.
Wybierz Baza danych na stronie Wybierz typ źródła danych, 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 bazie danych Northwind jest dostępna na liście rozwijanej, zaznacz go.
  
  Lub
- Wybierz pozycję Nowe połączenie, aby otworzyć okno dialogowe Dodawanie/modyfikowanie połączenia.
Jeśli baza danych wymaga hasła, wybierz opcję dołączenia danych poufnych, a następnie kliknij przycisk Dalej.
Na stronie Zapisz ciąg połączeń do pliku konfiguracyjnego aplikacji kliknij Dalej.
Rozwiń węzeł Tabele na stronie Wybierz obiekty bazy danych.
Wybierz Customers tabeli, a następnie kliknij przycisk Zakończ.

NorthwindDataSet jest dodawany do projektu i Customers Tabela pojawi się w źródła danych okna.

Ustawienie kolumnę telefonu formant PhoneNumberBox

W ramach źródła danych okna można ustawić sterowania do utworzenia przed przeciągając elementy na formularzu.

Aby ustawić kolumny telefonu powiązać formant PhoneNumberBox

Otwórz Form1 w projektancie.
Rozwiń węzeł klienci w węźle źródła danych okna.
Kliknij strzałkę listy rozwijanej klienci węzła i wybierz polecenie Szczegóły z listy kontroli.
Kliknij strzałkę listy rozwijanej Phone kolumny i wybierz polecenie Dostosuj.
Wybierz PhoneNumberBox z listy skojarzonych formantów w Opcje dostosowania interfejsu użytkownika danych okno dialogowe.
Kliknij strzałkę listy rozwijanej Phone kolumny i wybierz polecenie PhoneNumberBox.

Dodawanie formantów do formularza

Można utworzyć, przeciągając elementy z formantów powiązanych z danymi źródła danych okna na formularzu.

Aby utworzyć formantów powiązanych z danymi

Przeciągnij głównym klienci węzła z źródła danych okna na formularzu i sprawdź, czy PhoneNumberBox kontroli jest używana do wyświetlania danych w Phone kolumny.

Formanty powiązane dane z opisowe etykiety są widoczne w formularzu, wraz z pasek narzędzi (BindingNavigator) do nawigowania rekordów.Element NorthwindDataSet, CustomersTableAdapter, BindingSource, i BindingNavigator są widoczne na pasku składnika.

Uruchamianie aplikacji

Aby uruchomić aplikację

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

Następne kroki

W zależności od potrzeb aplikacji istnieje kilka kroków, które można wykonać po utworzony formant, który obsługuje powiązania danych.Niektóre typowe kolejne kroki obejmują:

Umieszczanie niestandardowych formantów w Biblioteka formantów, więc możesz ponownie używać ich w innych aplikacjach.
Tworzenie formantów, które obsługują bardziej złożonych scenariuszy powiązania danych.Aby uzyskać więcej informacji, zobacz Wskazówki: tworzenie formantu użytkownika formularzy systemu Windows obsługującego złożone powiązanie danych i Wskazówki: tworzenie formantu użytkownika formularzy systemu Windows obsługującego powiązanie danych wyszukiwania.

Zobacz też

Udostępnij za pośrednictwem