Freigeben über


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

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:

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 SimpleControlWalkthrough.

  3. 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

  1. Klicken Sie im Menü Projekt auf Benutzersteuerelement hinzufügen.

  2. 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

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

  2. Wählen Sie das Smarttag für das gerade gezogene MaskedTextBox aus, und wählen Sie Maske festlegen aus.

  3. 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

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

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

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

  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 Anwendungskonfigurationsdatei speichern auf Weiter.

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

  8. 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

  1. Öffnen Sie Form1 im Designer.

  2. Erweitern Sie im Datenquellenfenster den Knoten Customers.

  3. Klicken Sie im Knoten Customers auf den Dropdownpfeil, und wählen Sie in der Steuerelementliste die Option Details aus.

  4. Klicken Sie in der Spalte Phone auf den Dropdownpfeil, und wählen Sie Anpassen aus.

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

  6. 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:

Siehe auch

Aufgaben

Gewusst wie: Festlegen des Steuerelements, das beim Ziehen aus dem Datenquellenfenster erstellt werden soll

Konzepte

Übersicht über das Anzeigen von Daten

Weitere Ressourcen

Erste Schritte mit dem Datenzugriff

Herstellen von Datenverbindungen in Visual Studio

Vorbereiten der Anwendung auf den Empfang von Daten

Abrufen von Daten für die Anwendung

Anzeigen von Daten in Formularen in Windows-Anwendungen

Bearbeiten von Daten in der Anwendung

Überprüfen von Daten

Speichern von Daten