Tworzenie kontrolki użytkownika programu .NET Framework Windows Forms obsługującej proste powiązanie danych

Uwaga

Zestawy danych i powiązane klasy to starsze technologie .NET Framework z początku 2000 roku, które umożliwiają aplikacjom pracę z danymi w pamięci, gdy aplikacje są odłączone od bazy danych. Technologie te są szczególnie przydatne w przypadku aplikacji, które umożliwiają użytkownikom modyfikowanie danych i utrwalanie zmian z powrotem w bazie danych. Mimo że zestawy danych okazały się bardzo udaną technologią, zalecamy, aby nowe aplikacje platformy .NET używały platformy Entity Framework Core. Program Entity Framework zapewnia bardziej naturalny sposób pracy z danymi tabelarycznymi jako modelami obiektów i ma prostszy interfejs programowania.

Podczas wyświetlania danych na formularzach w aplikacjach systemu Windows możesz wybrać istniejące kontrolki z przybornika lub utworzyć kontrolki niestandardowe, jeśli aplikacja wymaga funkcji, które nie są dostępne w standardowych kontrolkach. W tym przewodniku pokazano, jak utworzyć kontrolkę, która implementuje element DefaultBindingPropertyAttribute. Kontrolki implementujące DefaultBindingPropertyAttribute element może zawierać jedną właściwość, która może być powiązana z danymi. Takie kontrolki są podobne do kontrolek TextBox lub CheckBox.

Aby uzyskać więcej informacji na temat tworzenia kontrolek, zobacz Tworzenie kontrolek formularzy systemu Windows w czasie projektowania.

Podczas tworzenia kontrolek do użycia w scenariuszach powiązania danych należy zaimplementować jeden z następujących atrybutów powiązania danych:

Użycie atrybutu powiązania danych
Zaimplementuj kontrolki DefaultBindingPropertyAttribute na prostych kontrolkach, takich jak TextBox, które wyświetlają pojedynczą kolumnę (lub właściwość) danych. (Ten proces jest opisany na tej stronie przewodnika).
Zaimplementuj kontrolki ComplexBindingPropertiesAttribute włączone, takie jak DataGridView, które wyświetlają listy (lub tabele) danych. Aby uzyskać więcej informacji, zobacz Tworzenie kontrolki użytkownika formularzy systemu Windows, która obsługuje złożone powiązanie danych.
Zaimplementuj kontrolki LookupBindingPropertiesAttribute włączone, takie jak ComboBox, które wyświetlają listy (lub tabele) danych, ale także muszą przedstawić jedną kolumnę lub właściwość. Aby uzyskać więcej informacji, zobacz Tworzenie kontrolki użytkownika formularzy systemu Windows, która obsługuje powiązanie danych odnośników.

Ten przewodnik tworzy prostą kontrolkę, która wyświetla dane z jednej kolumny w tabeli. W tym przykładzie Phone użyto kolumny Customers tabeli z przykładowej bazy danych Northwind. Prosta kontrolka użytkownika wyświetla numery telefonów klientów w standardowym formacie numeru telefonu przy użyciu MaskedTextBox elementu i ustawiając maskę na numer telefonu.

W tym przewodniku dowiesz się, jak wykonywać następujące działania:

• Utwórz nową aplikację Windows Forms (.NET Framework).

• Dodaj nową kontrolkę użytkownika do projektu.

• Wizualnie projektuj kontrolkę użytkownika.

• Zaimplementuj DefaultBindingProperty atrybut .

• Tworzenie zestawu danych za pomocą kreatora konfiguracji źródła danych.

• Ustaw kolumnę Phone (Telefon) w oknie Źródła danych, aby użyć nowej kontrolki.

• Utwórz formularz do wyświetlania danych w nowej kontrolce.

Wymagania wstępne

Do ukończenia tego samouczka potrzebne są obciążenia tworzenia aplikacji klasycznych platformy .NET oraz przechowywania i przetwarzania danych zainstalowanych w programie Visual Studio. Aby je zainstalować, otwórz Instalator programu Visual Studio i wybierz pozycję Modyfikuj (lub Więcej>modyfikacji) obok wersji programu Visual Studio, którą chcesz zmodyfikować. Zobacz Modyfikowanie programu Visual Studio.

W tym przewodniku użyto bazy danych SQL Server Express LocalDB i przykładowej bazy danych Northwind.

1. Jeśli nie masz bazy danych SQL Server Express LocalDB, zainstaluj ją ze strony pobierania programu SQL Server Express lub za pośrednictwem Instalator programu Visual Studio. W Instalator programu Visual Studio można zainstalować bazę danych SQL Server Express LocalDB w ramach obciążenia Magazynu i przetwarzania danych lub jako pojedynczy składnik.

2. Zainstaluj przykładową bazę danych Northwind, wykonując następujące kroki:

   1. W programie Visual Studio otwórz okno Eksplorator obiektów programu SQL Server. (program SQL Server Eksplorator obiektów jest instalowany w ramach obciążenia Magazynu i przetwarzania danych w Instalator programu Visual Studio). Rozwiń węzeł PROGRAMU SQL Server. Kliknij prawym przyciskiem myszy wystąpienie bazy danych LocalDB i wybierz pozycję Nowe zapytanie.

      Zostanie otwarte okno edytora zapytań.

   2. Skopiuj skrypt Northwind Transact-SQL do schowka. Ten skrypt języka T-SQL tworzy bazę danych Northwind od podstaw i wypełnia ją danymi.

   3. Wklej skrypt języka T-SQL do edytora zapytań, a następnie wybierz przycisk Wykonaj .

      Po krótkim czasie zapytanie zakończy działanie i zostanie utworzona baza danych Northwind.

Tworzenie aplikacji Windows Forms

Pierwszym krokiem jest utworzenie aplikacji Windows Forms (.NET Framework)::

1. W programie Visual Studio w menu Plik wybierz pozycję Nowy>projekt.

2. Rozwiń węzeł Visual C# lub Visual Basic w okienku po lewej stronie, a następnie wybierz pozycję Pulpit systemu Windows.

3. W środkowym okienku wybierz typ projektu Aplikacja Windows Forms.

4. Nadaj projektowi nazwę SimpleControlWalkthrough, a następnie wybierz przycisk OK.

   Projekt SimpleControlWalkthrough jest tworzony i dodawany do Eksplorator rozwiązań.

Dodawanie kontrolki użytkownika do projektu

Ten przewodnik tworzy prostą kontrolkę powiązaną z danymi na podstawie kontrolki użytkownika. Dodaj element Kontrolka użytkownika do projektu SimpleControlWalkthrough:

1. Z menu Project (Projekt) wybierz pozycję Add User Control (Dodaj kontrolkę użytkownika).

2. Wpisz PhoneNumberBox w obszarze Nazwa, a następnie kliknij przycisk Dodaj.

   Kontrolka PhoneNumberBox jest dodawana do Eksplorator rozwiązań i otwierana w projektancie.

Projektowanie kontrolki PhoneNumberBox

Ten przewodnik rozszerza istniejący MaskedTextBox element, aby utworzyć kontrolkę PhoneNumberBox :

1. Przeciągnij element MaskedTextBox z przybornika na powierzchnię projektową kontrolki użytkownika.

2. Wybierz tag inteligentny po MaskedTextBox prostu przeciągnięty, a następnie wybierz pozycję Ustaw maskę.

3. Wybierz numer telefonu w oknie dialogowym Maska wejściowa, a następnie kliknij przycisk OK, aby ustawić maskę.

Dodawanie wymaganego atrybutu powiązania danych

W przypadku prostych kontrolek obsługujących powiązanie danych zaimplementuj element DefaultBindingPropertyAttribute:

1. Przełącz kontrolkę PhoneNumberBox na widok kodu. (Na stronie Wyświetl menu, wybierz pozycję Kod).

2. Zastąp kod w PhoneNumberBox następującym kodem:

   C#

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

   VB

   <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
   

3. W menu Kompilacja wybierz pozycję Kompiluj rozwiązanie.

Tworzenie źródła danych na podstawie bazy danych

W tym kroku użyto Kreatora konfiguracji źródła danych do utworzenia źródła danych na Customers podstawie tabeli w przykładowej bazie danych Northwind. Aby utworzyć połączenie, musisz mieć dostęp do przykładowej bazy danych Northwind. Aby uzyskać informacje na temat konfigurowania przykładowej bazy danych Northwind, zobacz Instrukcje: instalowanie przykładowych baz danych.

1. Aby otworzyć okno Źródła danych, w menu Dane kliknij pozycję Pokaż źródła danych.

2. W oknie Źródła danych wybierz pozycję Dodaj nowe źródło danych, aby uruchomić kreatora konfiguracji źródła danych.

3. Na stronie Wybierz typ źródła danych wybierz pozycję Baza danych, a następnie wybierz pozycję Dalej.

4. Na stronie Wybieranie połączenia danych wykonaj jedną z następujących czynności:

   • Jeśli na liście rozwijanej jest dostępne połączenie danych z przykładową bazą danych Northwind, wybierz je.

   • Wybierz pozycję Nowe połączenie , aby uruchomić okno dialogowe Dodawanie/Modyfikowanie połączenia .

5. Jeśli baza danych wymaga hasła, wybierz opcję dołączenia poufnych danych, a następnie wybierz przycisk Dalej.

6. Na stronie Zapisz parametry połączenia w pliku konfiguracji aplikacji kliknij przycisk Dalej.

7. Na stronie Wybieranie obiektów bazy danych rozwiń węzeł Tabele .

8. Wybierz tabelę Customers , a następnie wybierz pozycję Zakończ.

   Zestaw NorthwindDataSet jest dodawany do projektu, a Customers tabela zostanie wyświetlona w oknie Źródła danych.

Ustaw kolumnę phone na używanie kontrolki PhoneNumberBox

W oknie Źródła danych możesz ustawić kontrolkę do utworzenia przed przeciągnięciem elementów do formularza:

1. Otwórz formularz Form1 w projektancie.

2. Rozwiń węzeł Klienci w oknie Źródła danych.

3. Kliknij strzałkę listy rozwijanej w węźle Klienci , a następnie wybierz pozycję Szczegóły z listy kontrolnej.

4. Kliknij strzałkę listy rozwijanej w kolumnie Telefon , a następnie wybierz pozycję Dostosuj.

5. Wybierz pozycję PhoneNumberBox z listy Skojarzonych kontrolek w oknie dialogowym Opcje dostosowywania interfejsu użytkownika danych.

6. Kliknij strzałkę listy rozwijanej w kolumnie Phone (Telefon ), a następnie wybierz pozycję PhoneNumberBox.

Dodawanie kontrolek do formularza

Kontrolki powiązane z danymi można utworzyć, przeciągając elementy z okna Źródła danych na formularz.

Aby utworzyć kontrolki powiązane z danymi w formularzu, przeciągnij główny węzeł Klienci z okna Źródła danych do formularza i sprawdź, czy kontrolka PhoneNumberBox jest używana do wyświetlania danych w kolumnie Phone .

Kontrolki powiązane z danymi z etykietami opisowymi są wyświetlane w formularzu wraz z paskiem narzędzi (BindingNavigator) umożliwiającym nawigowanie po rekordach. Element NorthwindDataSet, CustomersTableAdapter, BindingSourcei BindingNavigator pojawi się na pasku składników.

Uruchamianie aplikacji

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

Następne kroki

W zależności od wymagań aplikacji można wykonać kilka kroków po utworzeniu kontrolki obsługującej powiązanie danych. Oto niektóre typowe następne kroki:

• Umieszczenie kontrolek niestandardowych w bibliotece kontrolek w celu ponownego użycia ich w innych aplikacjach.

• Tworzenie kontrolek obsługujących bardziej złożone scenariusze powiązania danych. Aby uzyskać więcej informacji, zobacz Create a Windows Forms user control that supports complex data binding and Create a Windows Forms user control that supports lookup data binding (Tworzenie kontrolki użytkownika formularzy systemu Windows, która obsługuje powiązanie danych odnośników).

Powiązana zawartość

• Wiązanie kontrolek Windows Forms z danymi w programie Visual Studio
• Ustawianie kontrolki do utworzenia podczas przeciągania z okna źródeł danych