Exemplarische Vorgehensweise: Speichern von Daten in einer Datenbank (eine Tabelle)

Artikel
08/10/2011

Eines der häufigsten Szenarios in der Anwendungsentwicklung ist das Anzeigen von Daten auf einem Formular in einer Windows-Anwendung, das Bearbeiten der Daten und das Senden der aktualisierten Daten zurück an die Datenbank. In dieser exemplarischen Vorgehensweise wird ein einfaches Formular erstellt, das Daten aus einer einzelnen Tabelle in einzelnen Steuerelementen anzeigt. Sie können die Daten in Steuerelementen bearbeiten und die Änderungen wieder in der Datenbank speichern. In diesem Beispiel wird die Tabelle Customers der Beispieldatenbank Northwind verwendet.

Sie können Daten in der Anwendung wieder in der Datenbank speichern, indem Sie die Update-Methode eines TableAdapter aufrufen. Wenn Sie Elemente aus dem Datenquellenfenster ziehen, wird Code zum Speichern von Daten automatisch für die erste auf ein Formular gezogene Tabelle hinzugefügt. Für alle weiteren einem Formular hinzugefügten Tabellen muss der zum Speichern von Daten erforderliche Code manuell hinzugefügt werden. Informationen zum Speichern von Daten aus mehreren Tabellen finden Sie unter Exemplarische Vorgehensweise: Speichern von Daten in einer Datenbank (mehrere Tabellen).

Zu den Aufgaben in dieser exemplarischen Vorgehensweise gehören:

Erstellen eines neuen Windows-Anwendung-Projekts.
Erstellen und Konfigurieren einer Datenquelle in der Anwendung mithilfe des Assistent zum Konfigurieren von Datenquellen.
Festlegen der Steuerelemente für die Elemente im Datenquellenfenster. Weitere Informationen finden Sie unter Gewusst wie: Festlegen des Steuerelements, das beim Ziehen aus dem Datenquellenfenster erstellt werden soll.
Erstellen datengebundener Steuerelemente durch Ziehen von Elementen aus dem Datenquellenfenster auf das Formular.
Ändern einiger Datensätze im Dataset.
Hinzufügen von Code zum Zurücksenden der aktualisierten Daten im Dataset an die Datenbank.

Tipp

Je nach den aktiven Einstellungen oder der Version unterscheiden sich die Dialogfelder und Menübefehle auf Ihrem Bildschirm möglicherweise von den in der Hilfe beschriebenen. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Arbeiten mit Einstellungen.

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 der Windows-Anwendung

Im ersten Schritt wird eine Windows-Anwendung erstellt. Dem Projekt kann an dieser Stelle optional ein Name zugewiesen werden. In diesem Fall wird dem Projekt ein Name zugewiesen, weil es später gespeichert werden soll.

So erstellen Sie das neue Windows-Anwendungsprojekt

Erstellen Sie im Menü Datei ein neues Projekt.
Nennen Sie das Projekt UpdateSingleTableWalkthrough.
Wählen Sie Windows-Anwendung aus, und klicken Sie auf OK. Weitere Informationen finden Sie unter Erstellen von Windows-basierten Anwendungen.

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

Erstellen der Datenquelle

In diesem Schritt wird mit dem Assistenten zum Konfigurieren von Datenquellen eine Datenquelle aus der Northwind-Datenbank erstellt. Sie benötigen Zugriff auf die Beispieldatenbank Northwind, um den Assistenten verwenden 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 dem Projekt hinzugefügt. Die Tabelle Customers wird im Datenquellenfenster angezeigt.

Festlegen der zu erstellenden Steuerelemente

Für diese exemplarische Vorgehensweise wird ein Detaillayout verwendet, d. h. die Daten werden in einzelnen Steuerelementen und nicht im DataGridView-Standardlayout angezeigt.

So legen Sie die Steuerelemente für die Elemente im Datenquellenfenster fest

Erweitern Sie im Datenquellenfenster den Knoten Customers.
Ändern Sie das Steuerelement für die Tabelle Customers in einzelne Steuerelemente, indem Sie Details in der Dropdownliste des Knotens Customers auswählen. Weitere Informationen finden Sie unter Gewusst wie: Festlegen des Steuerelements, das beim Ziehen aus dem Datenquellenfenster erstellt werden soll.

Erstellen des datengebundenen Formulars

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

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 auf der Komponentenleiste angezeigt.

Ändern von Code zum Aktualisieren der Datenbank

Sie können die Datenbank aktualisieren, indem Sie die Update-Methode von CustomersTableAdapter aufrufen. Ein Ereignishandler für die BindingNavigator-Schaltfläche Speichern wird standardmäßig zum Code des Formulars hinzugefügt, damit Aktualisierungen an die Datenbank gesendet werden. In dieser Prozedur wird die Fehlerbehandlung zum Code hinzugefügt, indem der Aktualisierungsaufruf mit einem Try-Catch-Block umschlossen wird. Sie können den Code entsprechend den Anforderungen der Anwendung anpassen.

So fügen Sie der Anwendung Aktualisierungslogik hinzu

Doppelklicken Sie auf dem BindingNavigator auf die Schaltfläche Speichern, um den Code-Editor für den bindingNavigatorSaveItem_Click-Ereignishandler zu öffnen.

Bearbeiten Sie den Code im Ereignishandler, sodass die Fehlerbehandlung hinzugefügt wird. Der Code sollte wie folgt aussehen:

Try
    Me.Validate()
    Me.CustomersBindingSource.EndEdit()
    Me.CustomersTableAdapter.Update(Me.NorthwindDataSet.Customers)
    MsgBox("Update successful")

Catch ex As Exception
    MsgBox("Update failed")
End Try

try
{
    this.Validate();
    this.customersBindingSource.EndEdit();
    this.customersTableAdapter.Update(this.northwindDataSet.Customers);
    MessageBox.Show("Update successful");
}
catch (System.Exception ex)
{
    MessageBox.Show("Update failed");
}

Testen der Anwendung

So testen Sie die Anwendung

Drücken Sie F5.
Nehmen Sie einige Änderungen an den Daten eines oder mehrerer Datensätze vor.
Klicken Sie auf die Schaltfläche Speichern.
Überprüfen Sie die Werte in der Datenbank, um sicherzustellen, dass die Änderungen gespeichert wurden.

Nächste Schritte

Je nach den Anforderungen der Anwendung können nach dem Erstellen eines datengebundenen Formulars in der Windows-Anwendung weitere Schritte sinnvoll sein. Sie können an dieser exemplarischen Vorgehensweise beispielsweise folgende Verbesserungen vornehmen: