Exemplarische Vorgehensweise: Erstellen eines Benutzersteuerelements, das einfache Datenbindung unterstützt

Artikel
09/02/2008

Aktualisiert: November 2007

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 DefaultBindingPropertyAttribute implementiert. Steuerelemente, die DefaultBindingPropertyAttribute implementieren, können genau eine Eigenschaft enthalten, die an Daten gebunden werden kann. Solche Steuerelemente ähneln dem TextBox-Steuerelement und dem CheckBox-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. (Dieser Prozess wird in dieser exemplarischen Vorgehensweise beschrieben.)
Implementieren Sie ComplexBindingPropertiesAttribute für Steuerelemente, die Listen (oder Tabellen) von Daten anzeigen, wie das DataGridView-Steuerelement. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Benutzersteuerelements, das komplexe Datenbindung unterstützt.
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 Benutzersteuerelements, das die Nachschlagedatenbindung unterstützt.

In dieser exemplarischen Vorgehensweise wird ein einfaches Steuerelement erstellt, das Daten aus einer einzelnen Spalte in einer Tabelle anzeigt. In diesem Beispiel wird die Spalte Phone der Tabelle Customers der Beispieldatenbank Northwind verwendet. Das einfache Benutzersteuerelement zeigt die Telefonnummern der Kunden in einem Standardformat für Telefonnummern an. Dazu wird eine MaskedTextBox verwendet, und die Maske wird auf eine Telefonnummer festgelegt.

Im Rahmen dieser exemplarischen Vorgehensweise erhalten Sie Informationen zu folgenden Vorgängen:

Erstellen einer neuen Windows-Anwendung.
Hinzufügen eines neuen Benutzersteuerelements zu einem Projekt.
Entwerfen des Benutzersteuerelements im visuellen Designer.
Implementieren des DefaultBindingProperty-Attributs.
Erstellen eines Datasets mit dem Assistent zum Konfigurieren von Datenquellen.
Festlegen der Spalte Phone auf die Verwendung des neuen Steuerelements (im Datenquellenfenster).
Erstellen eines Formulars, um Daten in dem neuen Steuerelement anzuzeigen.

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 ein neues Windows-Projekt

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

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

Hinzufügen eines Benutzersteuerelements zum Projekt

In dieser exemplarischen Vorgehensweise wird aus einem Benutzersteuerelement ein einfaches datenbindungsfähiges Steuerelement erstellt. Fügen Sie dem Projekt SimpleControlWalkthrough zunächst also ein Benutzersteuerelement hinzu.

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 PhoneNumberBox ein, und klicken Sie auf Hinzufügen.

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

Entwerfen des PhoneNumberBox-Steuerelements

In dieser exemplarischen Vorgehensweise wird die vorhandene MaskedTextBox erweitert, um das PhoneNumberBox-Steuerelement zu erstellen.

So entwerfen Sie das PhoneNumberBox-Steuerelement

Ziehen Sie ein MaskedTextBox aus der Toolbox auf die Entwurfsoberfläche des Benutzersteuerelements.
Wählen Sie das Smarttag für das gerade gezogene MaskedTextBox aus, und wählen Sie Maske festlegen aus.
Wählen Sie im Dialogfeld Eingabeformat die Option Telefonnummer aus, und klicken Sie zum Festlegen der Maske auf OK.

Hinzufügen des erforderlichen Datenbindungsattributs

Implementieren Sie für einfache Steuerelemente, die Datenbindung unterstützen, das DefaultBindingPropertyAttribute.

So implementieren Sie das DefaultBindingProperty-Attribut

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

Ersetzen Sie den Code in PhoneNumberBox durch folgenden Code:

<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

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

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.
Gehen Sie auf der Seite Wählen Sie Ihre Datenverbindung aus auf eine der folgenden Arten vor:
- Wenn in der Dropdownliste eine Datenverbindung zur Beispieldatenbank Northwind verfügbar ist, wählen Sie diese 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 Anwendungskonfigurationsdatei 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, dass die Spalte "Phone" das PhoneNumberBox-Steuerelement verwenden soll

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 "Phone" an das PhoneNumberBox-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 in der Steuerelementliste die Option Details aus.
Klicken Sie in der Spalte Phone 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 PhoneNumberBox aus.
Klicken Sie in der Spalte Phone auf den Dropdownpfeil, und wählen Sie PhoneNumberBox 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 PhoneNumberBox-Steuerelement zum Anzeigen der Daten in der Spalte Phone verwendet wird.

Auf dem Formular werden datengebundene Steuerelemente mit beschreibenden Bezeichnungen sowie ein Toolstrip (BindingNavigator) für die Navigation in den Datensätzen angezeigt. NorthwindDataSet, CustomersTableAdapter, BindingSource und BindingNavigator werden im Komponentenfach angezeigt.

Ausführen der Anwendung

So führen Sie die Anwendung aus

Drucken 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. Weitere Informationen finden Sie unter Vorlage für Windows-Steuerelementbibliothek.
Erstellen Sie Steuerelemente, die komplexere Datenbindungsszenarios unterstützen. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Benutzersteuerelements, das komplexe Datenbindung unterstützt und Exemplarische Vorgehensweise: Erstellen eines Benutzersteuerelements, das die Nachschlagedatenbindung unterstützt.

Siehe auch

Freigeben über