Exemplarische Vorgehensweise: Speichern von Daten in einer Datenbank (eine Tabelle)
Aktualisiert: November 2007
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.
Hinweis: |
---|
Je nach den aktiven Einstellungen oder der verwendeten Version können sich die angezeigten Dialogfelder und Menübefehle von den in der Hilfe beschriebenen unterscheiden. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Visual Studio-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 dann auf Weiter.
Führen Sie auf der Seite Wählen Sie Ihre Datenverbindung aus 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).
Wenn für die Datenbank ein Kennwort erforderlich ist, 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 im Komponentenfach 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 in einen Try-Catch-Block eingefügt 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:
Fügen Sie dem Formular Suchfunktionalität hinzu. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen einer parametrisierten Abfrage zu einem Formular in einer Windows-Anwendung.
Hinzufügen von Steuerelementen, die verknüpfte Daten anzeigen. Weitere Informationen finden Sie unter Gewusst wie: Anzeigen von verknüpften Daten in einer Windows-Anwendung.
Bearbeiten der Datenquelle zum Hinzufügen oder Entfernen von Datenbankobjekten. Weitere Informationen finden Sie unter Gewusst wie: Bearbeiten eines Datasets.
Siehe auch
Konzepte
Übersicht über das Anzeigen von Daten
Weitere Ressourcen
Exemplarische Vorgehensweisen zur Arbeit mit Daten
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