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

Artikel
09/02/2008

Aktualisiert: November 2007

Diese exemplarische Vorgehensweise enthält ausführliche Anweisungen zum direkten Ausführen von SQL-Anweisungen für eine Datenbank mithilfe der DBDirect-Methoden eines TableAdapter. Mit den DBDirect-Methoden eines TableAdapter können Sie die Datenbankaktualisierungen detailliert steuern. Sie können mit diesen Methoden spezifische SQL-Anweisungen und gespeicherte Prozeduren ausführen, indem Sie die Methoden Insert, Update und Delete ganz nach Bedarf der Anwendung einzeln aufrufen – während die überladene Update-Methode alle UPDATE-, INSERT- und DELETE-Anweisungen in einem Aufruf ausführt.

Im Rahmen dieser exemplarischen Vorgehensweise erhalten Sie Informationen zu folgenden Vorgängen:

Erstellen einer neuen Windows-Anwendung.
Erstellen und Konfigurieren eines Datasets mithilfe des Assistent zum Konfigurieren von Datenquellen.
Auswählen des Steuerelements, das auf dem 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, um direkt auf die Datenbank zuzugreifen und Einfügungen, Aktualisierungen und Löschungen direkt in der Datenbank auszuführen.

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 Erstellen von Windows-basierten Anwendungen.

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

Erstellen einer Datenquelle aus einer Datenbank

In diesem Schritt wird mithilfe des Assistenten zum Konfigurieren von Datenquellen eine Datenquelle erstellt, die auf der Tabelle Region 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

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.
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).
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 Anwendungskonfigurationsdatei speichern auf Weiter.
Erweitern Sie auf der Seite Datenbankobjekte auswählen den Knoten Tabellen.
Wählen Sie die Tabelle Region aus, und klicken Sie dann auf Fertig stellen.

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

So fügen Sie dem Formular Steuerelemente zum Anzeigen der Daten hinzu

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. NorthwindDataSet, RegionTableAdapter, BindingSource und BindingNavigator werden im Komponentenfach angezeigt.

So fügen Sie Schaltflächen zum Aufrufen der einzelnen TableAdapter-DBDirect-Methoden hinzu

Ziehen Sie drei Button-Steuerelemente aus der Toolbox auf Form1 (unterhalb von RegionDataGridView).
Legen Sie für die Name-Eigenschaft und die Text-Eigenschaft der Schaltflächen jeweils folgende Werte fest.

Name

Text

InsertButton

Insert

UpdateButton

Update

DeleteButton

Delete

Name	Text
InsertButton	Insert
UpdateButton	Update
DeleteButton	Delete

So fügen Sie Code zum Einfügen neuer Datensätze in die Datenbank hinzu

Doppelklicken Sie auf den InsertButton, um einen Ereignishandler für das Klickereignis zu erstellen, und öffnen Sie das Formular im Code-Editor.

Ersetzen Sie den InsertButton_Click-Ereignishandler durch folgenden Code:

Private Sub InsertButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    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);
}

So fügen Sie Code zum Aktualisieren der Datensätze in der Datenbank hinzu

Doppelklicken Sie auf den UpdateButton, um einen Ereignishandler für das Klickereignis zu erstellen, und öffnen Sie das Formular im Code-Editor.

Ersetzen Sie den UpdateButton_Click-Ereignishandler durch folgenden Code:

Private Sub UpdateButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    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();
}

So fügen Sie Code zum Löschen von Datensätzen aus der Datenbank hinzu

Doppelklicken Sie auf den DeleteButton, um einen Ereignishandler für das Klickereignis zu erstellen, und öffnen Sie das Formular im Code-Editor.

Ersetzen Sie den DeleteButton_Click-Ereignishandler durch folgenden Code:

Private Sub DeleteButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    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

Drucken Sie F5, um die Anwendung auszuführen.
Klicken Sie auf die Schaltfläche Insert, und überprüfen Sie, ob der neue Datensatz im Datenblatt angezeigt wird.
Klicken Sie auf die Schaltfläche Update, und überprüfen Sie, ob der Datensatz im Datenblatt aktualisiert wird.
Klicken Sie auf die Schaltfläche Delete, und überprüfen Sie, ob der Datensatz aus dem Datenblatt entfernt wird.

Nächste Schritte

Abhängig von den Anforderungen an die Anwendung können Sie nach der Erstellung eines datengebundenen Formulars noch weitere Schritte ausführen. Sie können an der vorliegenden exemplarischen Vorgehensweise u. a. folgende Verbesserungen vornehmen:

Fügen Sie dem Formular eine Suchfunktionalität hinzu. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen einer parametrisierten Abfrage zu einem Formular in einer Windows-Anwendung.
Fügen Sie dem Dataset weitere Tabellen hinzu, indem Sie die Option DataSet mit Assistent konfigurieren im Fenster Datenquellen auswählen. Sie können Steuerelemente zum Anzeigen von zugehörigen Daten hinzufügen, indem Sie die zugehörigen Knoten auf das Formular ziehen. Weitere Informationen finden Sie unter Gewusst wie: Anzeigen von verknüpften Daten in einer Windows-Anwendung.

Siehe auch

Freigeben über