Gewusst wie: Aktualisieren von Daten mit einem TableAdapter

Článek
09/02/2008

Aktualisiert: November 2007

Nachdem die Daten im Dataset geändert und überprüft wurden, können Sie die aktualisierten Daten an eine Datenbank zurückschicken. Um die geänderten Daten an eine Datenbank zu senden, rufen Sie die Update-Methode für einen TableAdapter auf. Die Update-Methode des Adapters aktualisiert eine einzelne Datentabelle und führt auf der Grundlage des RowState der einzelnen Datenzeilen in der Tabelle den entsprechenden Befehl (INSERT, UPDATE oder DELETE) aus. Beim Speichern von Daten in verknüpften Tabellen wird von Visual Studio 2008 eine neue TableAdapterManager-Komponente bereitgestellt, die beim Speichern in der richtigen Reihenfolge basierend auf den in der Datenbank festgelegten Fremdschlüsseleinschränkungen hilft. Weitere Informationen finden Sie unter Übersicht über die hierarchische Aktualisierung.

Hinweis:
Da bei dem Versuch, eine Datenquelle mit dem Inhalt eines DataSet zu aktualisieren, Fehler auftreten können, sollte der Code, der die Update-Methode des Adapters aufruft, in einem try/catch-Block platziert werden.

Die genaue Verfahrensweise zum Aktualisieren einer Datenquelle kann je nach Unternehmensanforderungen variieren. Die folgenden Schritte sollten jedoch von der Anwendung ausgeführt werden:

Rufen Sie die Update-Methode des Adapters in einem try/catch-Block auf.
Lokalisieren der fehlerhaften Datenzeile, falls eine Ausnahme abgefangen wird. Weitere Informationen finden Sie unter Gewusst wie: Suchen nach Zeilen mit Fehlern.
Beheben Sie das Problem in der Datenzeile (möglichst programmgesteuert oder indem die ungültige Zeile dem Benutzer zur Änderung angezeigt wird), und wiederholen Sie dann den Aktualisierungsversuch (HasErrors, GetErrors).

Speichern von Daten in einer Datenbank

Rufen Sie die Update-Methode eines TableAdapter auf, und übergeben Sie den Namen der Datentabelle, die die in die Datenbank zu schreibenden Werte enthält.

So aktualisieren Sie eine Datenbank mit einem DataSet mithilfe eines TableAdapter

Schließen Sie die Update-Methode des Adapters in einen try/catch-Block ein. Im folgenden Beispiel wird veranschaulicht, wie eine Aktualisierung mit dem Inhalt der Customers-Tabelle in NorthwindDataSet innerhalb eines try/catch-Blocks versucht wird.

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

Aktualisieren von zwei verknüpften Tabellen in einem Dataset mittels TableAdapter

Bei der Aktualisierung verknüpfter Tabellen in einem DatasSet muss die richtige Reihenfolge eingehalten werden, damit nicht unnötig Einschränkungen für die referenzielle Integrität verletzt werden. Die Reihenfolge der Befehlsausführung richtet sich auch nach den Indizes der DataRowCollection im Dataset. Um Datenintegritätsfehler zu verhindern, sollte die Datenbank möglichst in der folgenden Reihenfolge aktualisiert werden:

Untergeordnete Tabelle: Datensätze löschen.
Übergeordnete Tabelle: Datensätze einfügen, aktualisieren und löschen.

Untergeordnete Tabelle: Datensätze einfügen und aktualisieren.

Hinweis:
Wenn Sie zwei oder mehr verknüpfte Tabellen aktualisieren, muss die gesamte Aktualisierungslogik in einer Transaktion enthalten sein. Eine Transaktion ist ein Prozess zum Sicherstellen, dass alle mit einer Datenbank verbundenen Änderungen erfolgreich sind, bevor ein Commit der Änderungen ausgeführt wird. Weitere Informationen finden Sie unter Transaktionen und Parallelität (ADO.NET).

So aktualisieren Sie zwei verknüpfte Tabellen mittels TableAdapter

Erstellen Sie drei temporäre Datentabellen, die die unterschiedlichen Datensätze enthalten.
Rufen Sie die Update-Methode für jede Teilmenge der Zeilen in einem try/catch-Block auf. Wenn Aktualisierungsfehler auftreten, müssen diese durch eine Verzweigung behoben werden.
Übernehmen Sie die Änderungen in der Datenbank.

Löschen Sie die temporären Datentabellen, um die Ressourcen freizugeben.

Im folgenden Beispiel wird erläutert, wie Sie eine Datenquelle mit einem Dataset aktualisieren, das verknüpfte Tabellen enthält.

Private Sub UpdateDB()
    Dim deletedChildRecords As NorthwindDataSet.OrdersDataTable = _
        CType(NorthwindDataSet.Orders.GetChanges(Data.DataRowState.Deleted), NorthwindDataSet.OrdersDataTable)

    Dim newChildRecords As NorthwindDataSet.OrdersDataTable = _
        CType(NorthwindDataSet.Orders.GetChanges(Data.DataRowState.Added), NorthwindDataSet.OrdersDataTable)

    Dim modifiedChildRecords As NorthwindDataSet.OrdersDataTable = _
        CType(NorthwindDataSet.Orders.GetChanges(Data.DataRowState.Modified), NorthwindDataSet.OrdersDataTable)

    Try
        If deletedChildRecords IsNot Nothing Then
            OrdersTableAdapter.Update(deletedChildRecords)
        End If

        CustomersTableAdapter.Update(NorthwindDataSet.Customers)

        If newChildRecords IsNot Nothing Then
            OrdersTableAdapter.Update(newChildRecords)
        End If

        If modifiedChildRecords IsNot Nothing Then
            OrdersTableAdapter.Update(modifiedChildRecords)
        End If

        NorthwindDataSet.AcceptChanges()

    Catch ex As Exception
        MessageBox.Show("An error occurred during the update process")
        ' Add code to handle error here.

    Finally
        If deletedChildRecords IsNot Nothing Then
            deletedChildRecords.Dispose()
        End If

        If newChildRecords IsNot Nothing Then
            newChildRecords.Dispose()
        End If

        If modifiedChildRecords IsNot Nothing Then
            modifiedChildRecords.Dispose()
        End If

    End Try
End Sub

void UpdateDB()
{
    NorthwindDataSet.OrdersDataTable deletedChildRecords = 
        (NorthwindDataSet.OrdersDataTable)northwindDataSet.Orders.GetChanges(DataRowState.Deleted);

    NorthwindDataSet.OrdersDataTable newChildRecords = 
        (NorthwindDataSet.OrdersDataTable)northwindDataSet.Orders.GetChanges(DataRowState.Added);

    NorthwindDataSet.OrdersDataTable modifiedChildRecords = 
        (NorthwindDataSet.OrdersDataTable)northwindDataSet.Orders.GetChanges(DataRowState.Modified);

    try
    {
        if (deletedChildRecords != null)
        {
            ordersTableAdapter.Update(deletedChildRecords);
        }

        customersTableAdapter.Update(northwindDataSet.Customers);

        if (newChildRecords != null)
        {
            ordersTableAdapter.Update(newChildRecords);
        }

        if (modifiedChildRecords != null)
        {
            ordersTableAdapter.Update(modifiedChildRecords);
        }

        northwindDataSet.AcceptChanges();
    }

    catch (Exception ex)
    {
        MessageBox.Show("An error occurred during the update process");
        // Add code to handle error here.
    }

    finally
    {
        if (deletedChildRecords != null)
        {
            deletedChildRecords.Dispose();
        }
        if (newChildRecords != null)
        {
            newChildRecords.Dispose();
        }
        if (modifiedChildRecords != null)
        {
            modifiedChildRecords.Dispose();
        }
    }
}