Udostępnij za pośrednictwem


Instruktaż: Tworzenie formantu użytkownika Windows Forms tego powiązania obsługuje złożonych danych

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 ComplexBindingPropertiesAttribute.Kontroluje, że wdrożenie ComplexBindingPropertiesAttribute zawierają DataSource i DataMember właściwość, która może być powiązany z danymi.Takie kontrole są podobne do DataGridView lub ListBox.

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

Podczas tworzenia formantów do użycia w scenariuszach databinding 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.Aby uzyskać więcej informacji, zobacz Instruktaż: Tworzenie formantu użytkownika Windows Forms obsługuje dane proste powiązanie.

Wdrożenie ComplexBindingPropertiesAttribute na formanty, jak DataGridView, że wyświetlanie list (lub tabele) danych.(Ten proces jest opisany w tym instruktażu strony).

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 złożonych formant, który wyświetla wiersze danych z tabeli.W tym przykładzie Customers tabeli z bazy danych Northwind.Kontrola złożonych użytkownika będą wyświetlane w tabeli Klienci DataGridView w formancie niestandardowym.

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

  • Tworzenie zestawu danych z Kreator konfiguracji źródła danych.

  • Ustaw Klienci tabeli w Okno źródła danych , aby użyć nowego formantu złożonego.

  • Dodaj nowego formantu, przeciągając go z Okno źródła danych na Form1.

Wymagania wstępne

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

Tworzenie aplikacji systemu Windows

Pierwszym krokiem jest utworzenie Aplikacji Windows.

Aby utworzyć nowy projekt systemu Windows

  1. W programie Visual Studio z pliku menu Utwórz nowy projektu.

  2. Nazwa projektu ComplexControlWalkthrough.

  3. Wybierz Aplikacji Windows i kliknij przycisk OK.Aby uzyskać więcej informacji, zobacz Tworzenie aplikacji klienta.

    ComplexControlWalkthrough projektu jest tworzony i dodawany do Solution Explorer.

Dodawanie formantu użytkownika do projektu

Ponieważ w tym instruktażu tworzy złożonych, które można powiązać dane formantu z Formantu użytkownika, należy dodać Formantu użytkownika element do projektu.

Aby dodać formant użytkownika do projektu

  1. Z projektu menu wybierz Dodaj formant użytkownika.

  2. Wpisz ComplexDataGridView w Nazwa obszar, a następnie kliknij Dodaj.

    ComplexDataGridView kontroli jest dodawany do Solution Explorer i otwiera projektanta.

Projektowania formantu ComplexDataGridView

Dodaje ten krok DataGridView do kontroli użytkownika.

Aby zaprojektować formant ComplexDataGridView

  • Przeciągnij DataGridView z Przybornik na powierzchnię projektu kontroli użytkownika.

Dodawanie wymaganego atrybutu powiązanie danych

Kompleks formantów tego wsparcia wiązania danych, można zaimplementować ComplexBindingPropertiesAttribute.

Aby zaimplementować atrybutu ComplexBindingProperties

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

  2. Zastąp kod w ComplexDataGridView z następujących czynności:

    <System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")>
    Public Class ComplexDataGridView
    
        Public Property DataSource() As Object
            Get
                Return DataGridView1.DataSource
            End Get
            Set(ByVal value As Object)
                DataGridView1.DataSource = value
            End Set
        End Property
    
        Public Property DataMember() As String
            Get
                Return DataGridView1.DataMember
            End Get
            Set(ByVal value As String)
                DataGridView1.DataMember = value
            End Set
        End Property
    End Class
    
    using System.Windows.Forms;
    
    namespace CS
    {
        [System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")]
        public partial class ComplexDataGridView : UserControl
        {
            public object DataSource
            {
                get{ return dataGridView1.DataSource; }
                set{ dataGridView1.DataSource = value; }
            }
    
            public string DataMember
            {
                get{ return dataGridView1.DataMember; }
                set{ dataGridView1.DataMember = value; }
            }
    
            public ComplexDataGridView()
            {
                InitializeComponent();
            }
        }
    }
    
  3. 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

  1. Na dane menu, kliknij Pokaż źródeł danych.

  2. W Źródeł danych okno select Dodać nowe źródło danych uruchomić Kreatora konfiguracji źródła danych.

  3. Wybierz bazy danych na Wybierz typ źródła danych strony, a następnie kliknij Dalej.

  4. 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).

  5. Jeśli baza danych wymaga podania hasła, zaznacz opcję zawierają dane poufne, a następnie kliknij przycisk Dalej.

  6. Kliknij Dalej na zapisać ciąg połączenia w pliku konfiguracyjnym aplikacji strony.

  7. Rozwiń tabel węzeł na Wybierz obiekty bazy danych strony.

  8. 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 tabeli Klienci, aby użyć formantu ComplexDataGridView

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

Aby ustawić tabelę Klienci powiązać formant ComplexDataGridView

  1. Otwórz Form1 w projektancie.

  2. Rozwiń Klienci węzeł w Źródeł danych okna.

  3. Kliknij strzałkę rozwijania w Klienci węzła i wybierz polecenie Dostosuj.

  4. Wybierz ComplexDataGridView z listy Związane formanty w Opcje dostosowywania interfejsu użytkownika danych okno dialogowe.

  5. Kliknij strzałkę rozwijania w Customers tabeli i wybierz polecenie ComplexDataGridView z listy kontroli.

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 ComplexDataGridView formantu służy do wyświetlania danych tabeli.

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 z danymi.Niektóre typowe następne kroki obejmują:

Zobacz też

Zadania

Jak: formant ma zostać utworzony podczas przeciągania w oknie źródła danych

Koncepcje

Wiązanie formantów Windows Forms do danych w programie Visual Studio

Przygotowanie aplikacji do odbierania danych

Pobieranie danych do aplikacji

Wiązanie formantów z danych w programie Visual Studio

Edytowanie danych w aplikacji

Sprawdzanie poprawności danych

Zapisywanie danych

Inne zasoby

Formantów Windows Forms

Połączenie z danymi w programie Visual Studio