Utwórz kontrolkę użytkownika .NET Framework Windows Forms, która obsługuje wiązanie danych wyszukiwania.

Uwaga / Notatka

Klasy DataSet 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 w bazie danych. Mimo że zestawy danych są sprawdzoną pomyślną technologią, zalecaną metodą dla nowych aplikacji platformy .NET jest użycie platformy Entity Framework Core. Program Entity Framework zapewnia bardziej naturalny sposób pracy z danymi tabelarycznymi jako modelami obiektów i ma bardziej prosty interfejs programowania.

Podczas wyświetlania danych w formularzach systemu Windows można wybrać istniejące kontrolki z przybornika lub utworzyć kontrolki niestandardowe, jeśli aplikacja wymaga funkcji niedostępnych w standardowych kontrolkach. W tym przewodniku pokazano, jak utworzyć kontrolkę, która implementuje element LookupBindingPropertiesAttribute. Kontrolki, które implementują element LookupBindingPropertiesAttribute , mogą zawierać trzy właściwości, które mogą być powiązane z danymi. Takie kontrolki są podobne do ComboBox.

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. Aby uzyskać więcej informacji, zobacz Tworzenie kontrolki użytkownika formularzy systemu Windows, która obsługuje proste powiązanie danych.
Zaimplementuj ComplexBindingPropertiesAttribute na kontrolkach, takich 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 LookupBindingPropertiesAttribute na kontrolkach, takich jak ComboBox, które wyświetlają listy (lub tabele) danych, ale również muszą przedstawiać pojedynczą kolumnę lub właściwość. (Ten proces jest opisany na tej stronie przewodnika).

Ten przewodnik tworzy kontrolkę wyszukiwania, która wiąże się z danymi z dwóch tabel. W tym przykładzie użyto tabel Customers i Orders z przykładowej bazy danych Northwind. Kontrolka odnośnika jest powiązana z polem CustomerID z tabeli Orders. Używa tej wartości do wyszukania CompanyName elementu Customers z tabeli.

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 LookupBindingProperty atrybut .

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

• Ustaw kolumnę CustomerID w tabeli Orders (Zamówienia ) 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 .NEToraz przechowywania i przetwarzania danych zainstalowanych w programie Visual Studio. Aby je zainstalować, otwórz Instalator programu Visual Studio i wybierz Modyfikuj (lub Więcej>Modyfikuj) 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 LOCALDB programu SQL Server Express, zainstaluj ją ze strony pobierania programu SQL Server Express lub za pośrednictwem Instalatora programu Visual Studio. W instalatorze programu Visual Studiomożna zainstalować bazę danych SQL Server Express LocalDB w ramach magazynu danych i przetwarzania obciążenia 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 eksploratora obiektów programu SQL Server. (Eksplorator obiektów programu SQL Server jest instalowany w ramach obciążenia Magazyn danych i przetwarzanie w Instalatorze programu Visual Studio). Rozwiń węzeł 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 projektu aplikacji Windows Forms

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

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

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

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

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

   Projekt LookupControlWalkthrough jest tworzony i dodawany do Eksploratora rozwiązań.

Dodawanie kontrolki użytkownika do projektu

Ten przewodnik opisuje tworzenie kontrolki wyszukiwania z kontrolki użytkownika, więc dodaj kontrolkę użytkownika do projektu LookupControlWalkthrough.

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

2. Wpisz LookupBox w obszarze Nazwa , a następnie wybierz pozycję Dodaj.

   Kontrolka LookupBox jest dodawana do Eksploratora rozwiązań i otwierana w projektancie.

Projektowanie kontrolki LookupBox

Aby zaprojektować kontrolkę LookupBox, przeciągnij element ComboBox z przybornika na powierzchnię projektową kontrolki użytkownika.

Dodawanie wymaganego atrybutu powiązania danych

W przypadku kontrolek odnośników obsługujących powiązanie danych można zaimplementować element LookupBindingPropertiesAttribute.

1. Przełącz kontrolkę LookupBox na widok kodu. (W menu Widok wybierz pozycję Kod).

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

   C#

   using System.Windows.Forms;
   
   namespace CS
   {
       [System.ComponentModel.LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "LookupMember")]
       public partial class LookupBox : UserControl
       {
           public object DataSource
           {
               get{ return comboBox1.DataSource; }
               set{ comboBox1.DataSource = value; }
           }
   
           public string DisplayMember
           {
               get{ return comboBox1.DisplayMember; }
               set{ comboBox1.DisplayMember = value; }
           }
   
           public string ValueMember
           {
               get{ return comboBox1.ValueMember; }
               set{ comboBox1.ValueMember = value; }
           }
   
           public string LookupMember
           {
               get{ return comboBox1.SelectedValue.ToString(); }
               set{ comboBox1.SelectedValue = value; }
           }
   
   
           public LookupBox()
           {
               InitializeComponent();
           }
       }
   }
   

   VB

   <System.ComponentModel.LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "LookupMember")>
   Public Class LookupBox
   
       Public Property DataSource() As Object
           Get
               Return ComboBox1.DataSource
           End Get
           Set(ByVal value As Object)
               ComboBox1.DataSource = value
           End Set
       End Property
   
       Public Property DisplayMember() As String
           Get
               Return ComboBox1.DisplayMember
           End Get
           Set(ByVal value As String)
               ComboBox1.DisplayMember = value
           End Set
       End Property
   
       Public Property ValueMember() As String
           Get
               Return ComboBox1.ValueMember
           End Get
           Set(ByVal value As String)
               ComboBox1.ValueMember = value
           End Set
       End Property
   
       Public Property LookupMember() As String
           Get
               Return ComboBox1.SelectedValue.ToString()
           End Get
           Set(ByVal value As String)
               ComboBox1.SelectedValue = 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

Ten krok tworzy źródło danych przy użyciu kreatora Konfiguracji źródła danych, w oparciu o tabele Customers i Orders w przykładowej bazie danych Northwind.

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. Wybierz pozycję Baza danych na stronie Wybierz typ źródła 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 Zapisywanie parametrów połączenia w pliku konfiguracji aplikacji kliknij przycisk Dalej.

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

8. Wybierz tabele Customers i Orders , a następnie wybierz pozycję Zakończ.

   Zestaw danych NorthwindDataSet został dodany do projektu, a tabele Customers i Orders są wyświetlane w oknie Źródła danych.

Ustaw kolumnę CustomerID tabeli Orders na używanie kontrolki LookupBox

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. Rozwiń węzeł Zamówienia (jeden w węźle Klienci poniżej kolumny Faks ).

4. Kliknij strzałkę listy rozwijanej w węźle Orders (Zamówienia ) i wybierz pozycję Details (Szczegóły ) z listy kontrolnej.

5. Kliknij strzałkę listy rozwijanej w kolumnie CustomerID (w węźle Zamówienia ), a następnie wybierz pozycję Dostosuj.

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

7. Kliknij przycisk OK.

8. Kliknij strzałkę listy rozwijanej w kolumnie CustomerID i wybierz pozycję LookupBox.

Dodawanie kontrolek do formularza

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

Aby utworzyć kontrolki powiązane z danymi w formularzu systemu Windows, przeciągnij węzeł Orders (Zamówienia ) z okna Źródła danych na formularz systemu Windows i sprawdź, czy kontrolka LookupBox jest używana do wyświetlania danych w CustomerID kolumnie.

Powiąż kontrolkę, aby wyszukiwać nazwę firmy w tabeli 'Customers'

Aby skonfigurować powiązania odnośników, wybierz główny węzeł Klienci w oknie Źródła danych i przeciągnij go do pola kombi CustomerIDLookupBox w formularzu Form1.

Spowoduje to skonfigurowanie powiązania danych w celu wyświetlenia CompanyName z Customers tabeli, przy jednoczesnym zachowaniu wartości CustomerID z tabeli Orders.

Uruchamianie aplikacji

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

• Przeglądaj niektóre rekordy i sprawdź, czy CompanyName pojawia się w kontrolce LookupBox.

Treści powiązane

• Wiązanie kontrolek Windows Forms z danymi w programie Visual Studio