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

Artikel
02/26/2013

In Windows-Anwendungen können Sie zum Anzeigen von Daten in Formularen 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 DataSource-Eigenschaft und eine DataMember-Eigenschaft, die an Daten gebunden werden können.Solche Steuerelemente ähneln dem DataGridView-Steuerelement und dem ListBox-Steuerelement.

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 LookupBindingPropertiesAttribute für Steuerelemente, die Listen (oder Tabellen) von Daten anzeigen, aber auch eine einzelne Spalte oder Eigenschaft darstellen müssen, wie das ComboBox-Steuerelement.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 komplexes Steuerelement erstellt, das Datenzeilen aus einer Tabelle anzeigt.In diesem Beispiel wird die Tabelle Customers der Beispieldatenbank Northwind verwendet.Das komplexe Benutzersteuerelement zeigt die Tabelle Customers in einem DataGridView im benutzerdefinierten Steuerelement an.

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.
Festlegen der Tabelle Customers auf die Verwendung des neuen komplexen Steuerelements (im Datenquellenfenster).
Einfügen des neuen Steuerelements durch Ziehen vom Datenquellenfenster auf Form1.

Vorbereitungsmaßnahmen

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

Zugriff auf die Beispieldatenbank Northwind.Weitere Informationen finden Sie unter Gewusst wie: Installieren von Beispieldatenbanken.

Erstellen einer Windows-Anwendung

Im ersten Schritt wird eine Windows-Anwendung erstellt.

So erstellen Sie das neue Windows-Projekt

Erstellen Sie in Visual Studio im Menü Datei ein neues Projekt.
Geben Sie dem Projekt den Namen ComplexControlWalkthrough.
Wählen Sie Windows-Anwendung aus, und klicken Sie auf OK.Weitere Informationen finden Sie unter Entwickeln von Clientanwendungen.

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

Hinzufügen eines Benutzersteuerelements zum Projekt

Da in dieser exemplarischen Vorgehensweise aus einem Benutzersteuerelement ein komplexes datenbindungsfähiges Steuerelement erstellt wird, müssen Sie dem Projekt zunächst ein Benutzersteuerelement hinzufügen.

So fügen Sie dem Projekt ein Benutzersteuerelement hinzu

Klicken Sie im Menü Projekt auf Benutzersteuerelement hinzufügen.
Geben Sie im Bereich Name die Bezeichnung ComplexDataGridView ein, und klicken Sie auf Hinzufügen.

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

Entwerfen des ComplexDataGridView-Steuerelements

In diesem Schritt wird dem Benutzersteuerelement ein DataGridView hinzugefügt.

So entwerfen Sie das ComplexDataGridView-Steuerelement

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

Hinzufügen des erforderlichen Datenbindungsattributs

Implementieren Sie für komplexe Steuerelemente, die Datenbindung unterstützen, das ComplexBindingPropertiesAttribute.

So implementieren Sie das ComplexBindingProperties-Attribut

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

Ersetzen Sie den Code in ComplexDataGridView durch folgenden Code:

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

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

Erstellen einer Datenquelle aus einer Datenbank

In diesem Schritt wird mithilfe des Assistenten zum Konfigurieren von Datenquellen eine Datenquelle erstellt, die auf der Tabelle Customers in der Beispieldatenbank Northwind basiert.Sie müssen Zugriff auf die Beispieldatenbank Northwind haben, um die Verbindung erstellen zu können.Informationen zum Einrichten der Beispieldatenbank Northwind finden Sie unter Gewusst wie: Installieren von Beispieldatenbanken.

So erstellen Sie die Datenquelle

Klicken Sie im Menü Daten auf Datenquellen anzeigen.
Wählen Sie im Datenquellenfenster die Option Neue Datenquelle hinzufügen aus, um den Assistenten zum Konfigurieren von Datenquellen zu starten.
Wählen Sie auf der Seite Datenquellentyp auswählen die Option Datenbank aus, und klicken Sie auf Weiter.
Führen Sie auf der Seite Wählen Sie Ihre Datenverbindung einen der folgenden Schritte aus:
- Wenn eine Datenverbindung zur Beispieldatenbank Northwind in der Dropdownliste verfügbar ist, wählen Sie sie aus.
  
  - oder -
- Wählen Sie Neue Verbindung aus, um das Dialogfeld Verbindung hinzufügen/ändern zu öffnen.Weitere Informationen finden Sie unter Dialogfeld "Verbindung hinzufügen/ändern" (Allgemein).
Falls die Datenbank ein Kennwort erfordern sollte, aktivieren Sie die Option für die Einbeziehung vertraulicher Daten, und klicken Sie dann auf Weiter.
Klicken Sie auf der Seite Verbindungszeichenfolge in der Programmkonfigurationsdatei speichern auf Weiter.
Erweitern Sie auf der Seite Datenbankobjekte auswählen den Knoten Tabellen.
Wählen Sie die Tabelle Customers aus, und klicken Sie dann auf Fertig stellen.

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

Festlegen der Tabelle "Customers" auf die Verwendung des ComplexDataGridView-Steuerelements

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 Tabelle "Customers" an das ComplexDataGridView-Steuerelement fest

Öffnen Sie Form1 im Designer.
Erweitern Sie im Datenquellenfenster den Knoten Customers.
Klicken Sie im Knoten Customers auf den Dropdownpfeil, und wählen Sie Anpassen aus.
Wählen Sie im Dialogfeld Optionen für die Anpassung der Datenbenutzeroberfläche in der Liste Zugeordnete Steuerelemente den Eintrag ComplexDataGridView aus.
Klicken Sie in der Tabelle Customers auf den Dropdownpfeil, und wählen Sie in der Steuerelementliste ComplexDataGridView aus.

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 stellen Sie sicher, dass das ComplexDataGridView-Steuerelement zum Anzeigen der Tabellendaten 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

Abhängig von den Anforderungen an die Anwendung können Sie nach der Erstellung eines Steuerelements, das Datenbindung unterstützt, noch weitere Schritte ausführen.Als Nächstes können Sie u. a. folgende Schritte ausführen:

Fügen Sie die benutzerdefinierten Steuerelemente in eine Steuerelementbibliothek ein, damit Sie sie in anderen Anwendungen wiederverwenden können.
Erstellen Sie Steuerelemente, die Nachschlageszenarios unterstützen.Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Windows Forms-Benutzersteuerelements, das eine Datenbindung beim Suchen unterstützt.

Siehe auch

Freigeben über