Exemplarische Vorgehensweise: Speichern von Daten mit den TableAdapter-DBDirect-Methoden

Artikel
12/14/2016

Veröffentlicht: Juli 2016

Diese exemplarische Vorgehensweise enthält detaillierte Anweisungen für das Ausführen von SQL-Anweisungen direkt an einer Datenbank mithilfe von DBDirect-Methoden eines TableAdapters. Die DBDirect-Methoden eines TableAdapters bieten ein sehr gutes Maß an Kontrolle über Änderungen an der Datenbank. Damit können sie spezifische SQL-Anweisung und gespeicherter Prozeduren ausführen, indem Sie einzelne Insert-, Update- und Delete-Methoden aufrufen, ganz nach Bedarf der Anwendung (im Gegensatz zur überladenen Update-Methode, die die Anweisungen UPDATE, INSERT und DELETE in einem Aufruf ausführt).

Bei dieser exemplarischen Vorgehensweise lernen Sie Folgendes:

Erstellen Sie eine neue Windows-Anwendung.
Erstellen und Konfigurieren eines Datasets mit dem Assistent zum Konfigurieren von Datenquellen.
Wählen Sie das Steuerelement aus, das für das Formular erstellt werden soll, wenn Elemente aus dem Datenquellenfenster gezogen werden. Weitere Informationen finden Sie unter Festlegen des Steuerelements, das beim Ziehen aus dem Datenquellenfenster erstellt werden soll.
Erstellen eines datengebundenen Formulars durch Ziehen von Elementen aus dem Datenquellenfenster auf das Formular.
Hinzufügen von Methoden für den direkten Zugriff auf die Datenbank und das Durchführen von Einfügungen, Aktualisierung und Löschungen direkt an der Datenbank.

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 TableAdapterDbDirectMethodsWalkthrough.
Wählen Sie Windows-Anwendung aus, und klicken Sie auf OK. Weitere Informationen finden Sie unter Clientanwendungen.

Das Projekt TableAdapterDbDirectMethodsWalkthrough wird erstellt und zum Projektmappen-Explorer hinzugefügt.

Erstellen einer Datenquelle aus einer Datenbank

Dieser Schritt verwendet den Assistenten zum Konfigurieren von Datenquellen auf Grundlage der Region-Tabelle in der Beispieldatenbank Northwind. Sie benötigen Zugriff auf die Beispieldatenbank Northwind, um die Verbindung herstellen 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 in der Dropdownliste eine Datenverbindung zur Beispieldatenbank "Northwind" verfügbar ist, wählen Sie diese aus.
  
  - oder -
- Wählen Sie Neue Verbindung, um das Dialogfeld Verbindung hinzufügen/ändern zu öffnen.
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 Region-Tabelle und klicken Sie anschließend auf Fertig stellen.

NorthwindDataSet wird dem Projekt hinzugefügt. Die Tabelle Region wird im Datenquellenfenster angezeigt.

Hinzufügen von Steuerelementen zum Formular für das Anzeigen der Daten

Erstellen Sie die datengebundenen Steuerelemente, indem Sie Elemente aus dem Datenquellenfenster auf das Formular ziehen.

So erstellen Sie datengebundene Steuerelemente auf dem Windows Form

Ziehen Sie den Hauptknoten Region aus dem Datenquellenfenster auf das Formular.

Auf dem Formular wird ein DataGridView-Steuerelement und ein Toolstrip (BindingNavigator) für die Navigation in den Datensätzen angezeigt. Es wird eine NorthwindDataSet, RegionTableAdapter, BindingSource sowie eine BindingNavigator auf der Komponentenleiste angezeigt.

Hinzufügen von Schaltflächen, die die einzelnen TableAdapter DbDirect-Methoden aufruft

Ziehen Sie drei Button-Steuerelemente von der Symbolleiste auf Form1 (unter RegionDataGridView).
Legen Sie die folgenden Eigenschaften für Name und Text auf jeder Schaltfläche fest.

Name Text

InsertButton Insert

UpdateButton Aktualisieren

DeleteButton Löschen

Name	Text
`InsertButton`	Insert
`UpdateButton`	Aktualisieren
`DeleteButton`	Löschen

Hinzufügen von Code für das Einfügen neuer Datensätze in die Datenbank

Doppelklicken Sie InsertButton, sodass ein Ereignishandler für Click-Ereignis erstellt wird und öffnen Sie das Formular im Code-Editor.

Ersetzen Sie den Ereignishandler InsertButton_Clickdurch den folgenden Code:

        private void InsertButton_Click(object sender, EventArgs e)
        {
            Int32 newRegionID = 5;
            String newRegionDescription = "NorthEastern";

            try
            {
                regionTableAdapter1.Insert(newRegionID, newRegionDescription);
            }
            catch (Exception ex)
            {
                MessageBox.Show("Insert Failed");
            }
            RefreshDataset();
        }


        private void RefreshDataset()
        {
            this.regionTableAdapter1.Fill(this.northwindDataSet1.Region);
        }

    Private Sub InsertButton_Click() Handles InsertButton.Click

        Dim newRegionID As Integer = 5
        Dim newRegionDescription As String = "NorthEastern"

        Try
            RegionTableAdapter1.Insert(newRegionID, newRegionDescription)

        Catch ex As Exception
            MessageBox.Show("Insert Failed")
        End Try

        RefreshDataset()
    End Sub


    Private Sub RefreshDataset()
        Me.RegionTableAdapter1.Fill(Me.NorthwindDataSet1._Region)
    End Sub

Hinzufügen von Code für die Aktualisierung von Datensätzen in der Datenbank

Doppelklicken Sie UpdateButton, sodass ein Ereignishandler für Click-Ereignis erstellt wird und öffnen Sie das Formular im Code-Editor.

Ersetzen Sie den Ereignishandler UpdateButton_Clickdurch den folgenden Code:

        private void UpdateButton_Click(object sender, EventArgs e)
        {
            Int32 newRegionID = 5;

            try
            {
                regionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern");
            }
            catch (Exception ex)
            {
                MessageBox.Show("Update Failed");
            }
            RefreshDataset();
        }

    Private Sub UpdateButton_Click() Handles UpdateButton.Click

        Dim newRegionID As Integer = 5

        Try
            RegionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern")

        Catch ex As Exception
            MessageBox.Show("Update Failed")
        End Try

        RefreshDataset()
    End Sub

Hinzufügen von Code für das Löschen von Datensätzen in der Datenbank

Doppelklicken Sie DeleteButton, sodass ein Ereignishandler für Click-Ereignis erstellt wird und öffnen Sie das Formular im Code-Editor.

Ersetzen Sie den Ereignishandler DeleteButton_Clickdurch den folgenden Code:

        private void DeleteButton_Click(object sender, EventArgs e)
        {
            try
            {
                regionTableAdapter1.Delete(5, "Updated Region Description");
            }
            catch (Exception ex)
            {
                MessageBox.Show("Delete Failed");
            }
            RefreshDataset();
        }

    Private Sub DeleteButton_Click() Handles DeleteButton.Click

        Try
            RegionTableAdapter1.Delete(5, "Updated Region Description")

        Catch ex As Exception
            MessageBox.Show("Delete Failed")
        End Try

        RefreshDataset()
    End Sub

Ausführen der Anwendung

So führen Sie die Anwendung aus

Drücken Sie F5, um die Anwendung auszuführen.
Klicken Sie die Schaltfläche Einfügen und stellen Sie sicher, dass der neue Datensatz im Raster angezeigt wird.
Klicken Sie die Schaltfläche Aktualisieren und stellen Sie sicher, dass der Datensatz im Raster aktualisiert wurde.
Klicken Sie die Schaltfläche Löschen und stellen Sie sicher, dass der Datensatz aus dem Raster entfernt wurde.

Nächste Schritte

Entsprechend den Anforderungen an Ihre Anwendung können Sie nach der Erstellung eines datengebundenen Formulars noch weitere Schritte ausführen. 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 Forms-Anwendung.
Hinzufügen weiterer Tabellen zum Dataset durch Auswählen von DataSet mit Assistent konfigurieren aus dem Datenquellenfenster. Sie können Steuerelemente hinzufügen, die zugehörige Daten anzeigen, indem Sie die entsprechenden Knoten auf das Formular ziehen. Weitere Informationen finden Sie unter Gewusst wie: Anzeigen von verknüpften Daten in einer Windows Forms-Anwendung.

Siehe auch

Übersicht über TableAdapters
Gewusst wie: Direktes Zugreifen auf die Datenbank mit einem TableAdapter
Gewusst wie: Erstellen von TableAdapter-Abfragen
Gewusst wie: Speichern von Daten aus einem Objekt in einer Datenbank
Binden von Windows Forms-Steuerelementen an Daten in Visual Studio
Herstellen von Datenverbindungen in Visual Studio
Vorbereiten der Anwendung auf den Empfang von Daten
Abrufen von Daten für die Anwendung
Binden von Steuerelementen an Daten in Visual Studio
Bearbeiten von Daten in der Anwendung
Überprüfen von Daten
Speichern von Daten

Freigeben über