Freigeben über

Exemplarische Vorgehensweise: Erstellen eines Windows Forms-Benutzersteuerelements, das komplexe Datenbindung unterstützt

  • Artikel

 

Veröffentlicht: Juli 2016

Zum Anzeigen von Daten in Formularen in Windows-Anwendungen können Sie die in der Toolbox vorhandenen Steuerelemente verwenden oder – falls die gewünschte Funktionalität in den Standardsteuerelementen nicht verfügbar ist – benutzerdefinierte Steuerelemente erstellen. Diese exemplarische Vorgehensweise erläutert, wie Sie ein Steuerelement erstellen, das ComplexBindingPropertiesAttribute implementiert. Steuerelemente, die ComplexBindingPropertiesAttribute implementieren, enthalten eine Eigenschaft DataSource und DataMember, die an Daten gebunden werden kann. Solche Steuerelemente sind vergleichbar mit DataGridView oder ListBox.

Weitere Informationen zum Erstellen von Steuerelementen finden Sie unter Entwickeln von Windows Forms-Steuerelementen zur Entwurfszeit.

Beim Erstellen von Steuerelementen, die in Datenbindungsszenarios verwendet werden sollen, müssen Sie eines der folgenden Datenbindungsattribute implementieren:

Verwendung von Datenbindungsattributen
Implementieren Sie DefaultBindingPropertyAttribute für einfache Steuerelemente, die eine einzige Spalte (oder Eigenschaft) von Daten anzeigen, wie das TextBox-Steuerelement. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Windows Forms-Benutzersteuerelements, das einfache Datenbindung unterstützt.
Implementieren Sie ComplexBindingPropertiesAttribute für Steuerelemente, die Listen (oder Tabellen) von Daten anzeigen, wie das DataGridView-Steuerelement. (Dieser Prozess wird in dieser exemplarischen Vorgehensweise beschrieben.)
Implementieren Sie die LookupBindingPropertiesAttribute auf Steuerelementen wie einem ComboBox,das Listen (oder Tabellen) von Daten anzeigt, aber auch in einer einzelnen Spalte oder Eigenschaft vorhanden sein muss. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Windows Forms-Benutzersteuerelements, das eine Datenbindung beim Suchen unterstützt.

In dieser exemplarischen Vorgehensweise wird ein Steuerelement erstellt, das Datenzeilen aus einer Tabelle darstellt. In diesem Beispiel wird die Tabelle Customers der Beispieldatenbank Northwind verwendet. Das komplexe Benutzersteuerelement stellt die Tabelle Customers in einer DataGridView im benutzerdefinierten Steuerelement dar.

Bei dieser exemplarischen Vorgehensweise lernen Sie Folgendes:

  • Erstellen Sie eine neue Windows-Anwendung.

  • Hinzufügen eines neuen Benutzersteuerelements zu einem Projekt.

  • Entwerfen des Benutzersteuerelements im visuellen Designer.

  • Implementieren des ComplexBindingProperty-Attributs.

  • Erstellen eines Datasets mit dem Assistent zum Konfigurieren von Datenquellen.

  • Legt fest, dass die Tabelle Customers im Datenquellenfenster das neue, komplexe Steuerelement verwendet.

  • Fügen Sie das neue Steuerelement hinzu, indem Sie es vom Datenquellenfenster auf Form1 ziehen.

Vorbereitungsmaßnahmen

Für die Durchführung dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

Erstellen einer Windows-Anwendung

Im ersten Schritt wird eine Windows-Anwendung erstellt.

So erstellen Sie ein neues Windows-Projekt

  1. Erstellen Sie in Visual Studio im Menü Datei ein neues Projekt.

  2. Geben Sie dem Projekt den Namen ComplexControlWalkthrough.

  3. Wählen Sie Windows-Anwendung aus, und klicken Sie auf OK. Weitere Informationen finden Sie unter Clientanwendungen.

    Das Projekt ComplexControlWalkthrough wird erstellt und zum Projektmappen-Explorer hinzugefügt.

Hinzufügen eines Benutzersteuerelements zum Projekt

Weil diese exemplarische Vorgehensweise ein komplexes, datenbindbares Steuerelement aus einem Benutzersteuerelement erstellt, müssen Sie dem Projekt ein Benutzersteuerelement hinzufügen.

So fügen Sie dem Projekt ein Benutzersteuerelement hinzu

  1. Wählen Sie im Menü Projekt den Punkt Benutzersteuerelement hinzufügen.

  2. Geben Sie ComplexDataGridView in den Bereich Name ein und klicken Sie anschließend auf Hinzufügen.

    Das ComplexDataGridView-Steuerelement wird dem Projektmappen-Explorer hinzugefügt und im Designer geöffnet.

Entwerfen des ComplexDataGridView-Steuerelements

Dieser Schritt fügt dem Benutzersteuerelement eine DataGridView hinzu.

So entwerfen Sie das ComplexDataGridView-Steuerelement

  • Ziehen Sie ein DataGridView aus der Toolbox auf die Entwurfsoberfläche des Benutzersteuerelements.

Hinzufügen des erforderlichen Datenbindungsattributs

Für komplexe Steuerelemente, die Datenbindung unterstützen, können Sie das ComplexBindingPropertiesAttribute implementieren.

So implementieren Sie das ComplexBindingProperties-Attribut

  1. Wechseln Sie für das ComplexDataGridView-Steuerelement zur Codeansicht. (Wählen Sie aus dem Menü Ansicht den Punkt Code.)

  2. Ersetzen Sie den Code in ComplexDataGridView durch folgenden Code:

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

    <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

  3. Wählen Sie im Menü Erstellen die Option Projektmappe erstellen aus.

Erstellen einer Datenquelle aus einer Datenbank

Dieser Schritt verwendet den Assistenten zum Konfigurieren von Datenquellen auf Grundlage der Customers-Tabelle in der Beispieldatenbank Northwind. Sie benötigen Zugriff auf die Beispieldatenbank Northwind, um die Verbindung herstellen zu können. Informationen zum Einrichten der Beispieldatenbank Northwind finden Sie unter Gewusst wie: Installieren von Beispieldatenbanken.

So erstellen Sie die Datenquelle

  1. Klicken Sie im Menü Daten auf Datenquellen anzeigen.

  2. Wählen Sie im Datenquellenfenster die Option Neue Datenquelle hinzufügen aus, um den Assistenten zum Konfigurieren von Datenquellen zu starten.

  3. Wählen Sie auf der Seite Datenquellentyp auswählen die Option Datenbank aus, und klicken Sie auf Weiter.

  4. Führen Sie auf der Seite Wählen Sie Ihre Datenverbindung einen der folgenden Schritte aus:

    • Wenn in der Dropdownliste eine Datenverbindung zur Beispieldatenbank "Northwind" verfügbar ist, wählen Sie diese aus.

      - oder -

    • Wählen Sie Neue Verbindung, um das Dialogfeld Verbindung hinzufügen/ändern zu öffnen.

  5. Falls die Datenbank ein Kennwort erfordern sollte, aktivieren Sie die Option für die Einbeziehung vertraulicher Daten, und klicken Sie dann auf Weiter.

  6. Klicken Sie auf der Seite Verbindungszeichenfolge in der Programmkonfigurationsdatei speichern auf Weiter.

  7. Erweitern Sie auf der Seite Datenbankobjekte auswählen den Knoten Tabellen.

  8. Wählen Sie die Customers-Tabelle und klicken Sie anschließend auf Fertig stellen.

    NorthwindDataSet wird dem Projekt hinzugefügt. Die Tabelle Customers wird im Datenquellenfenster angezeigt.

Festlegen, dass die Spalte Customers das Steuerelement ComplexDataGridView verwendet

Im Datenquellenfenster können Sie vor dem Ziehen von Elementen auf das Formular festlegen, welches Steuerelement erstellt werden soll.

So legen Sie die Bindung der Spalte Customers an das ComplexDataGridView-Steuerelement fest

  1. Öffnen Sie Form1 im Designer.

  2. Erweitern Sie im Datenquellenfenster den Knoten Customers.

  3. Klicken Sie den Dropdown-Pfeil auf dem Knoten Customers und wählen Sie Anpassen.

  4. Wählen Sie im Dialogfeld Optionen für die Anpassung der Datenbenutzeroberfläche in der Liste Zugeordnete Steuerelemente den Eintrag ComplexDataGridView aus.

  5. Klicken Sie auf den Dropdownpfeil auf der Customers-Tabelle und wählen Sie ComplexDataGridView aus der Steuerungsliste.

Hinzufügen von Steuerelementen zum Formular

Sie können die datengebundenen Steuerelemente erstellen, indem Sie Elemente aus dem Datenquellenfenster auf das Formular ziehen.

So erstellen Sie datengebundene Steuerelemente auf dem Formular

  • Ziehen Sie den Hauptknoten Customers aus dem Datenquellenfenster auf das Formular und achten Sie darauf, dass das Steuerelement ComplexDataGridView zur Anzeige der Daten in der Tabelle verwendet wird.

Ausführen der Anwendung

So führen Sie die Anwendung aus

  • Drücken Sie F5, um die Anwendung auszuführen.

Nächste Schritte

Entsprechend den Anforderungen an Ihre Anwendung können Sie nach der Erstellung eines Steuerelements, das Datenbindung unterstützt, noch weitere Schritte ausführen. Zu den typischen nächsten Schritten gehören Folgende:

Siehe auch

Festlegen des Steuerelements, das beim Ziehen aus dem Datenquellenfenster erstellt werden soll
Windows Forms-Steuerelemente
Binden von Windows Forms-Steuerelementen an Daten in Visual Studio
Herstellen von Datenverbindungen in Visual Studio
Vorbereiten der Anwendung auf den Empfang von Daten
Abrufen von Daten für die Anwendung
Binden von Steuerelementen an Daten in Visual Studio
Bearbeiten von Daten in der Anwendung
Überprüfen von Daten
Speichern von Daten