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

Artikel
06/01/2015

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 Gewusst wie: 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 Entwickeln von Clientanwendungen mit .NET Framework.

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

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

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

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

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

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

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

Freigeben über