DataAdapter.Update(DataSet) Methode

public:
 virtual int Update(System::Data::DataSet ^ dataSet);

public:
 abstract int Update(System::Data::DataSet ^ dataSet);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("IDataReader's (built from adapter commands) schema table types cannot be statically analyzed.")]
public virtual int Update(System.Data.DataSet dataSet);

public virtual int Update(System.Data.DataSet dataSet);

public abstract int Update(System.Data.DataSet dataSet);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("IDataReader's (built from adapter commands) schema table types cannot be statically analyzed.")>]
abstract member Update : System.Data.DataSet -> int
override this.Update : System.Data.DataSet -> int

abstract member Update : System.Data.DataSet -> int
override this.Update : System.Data.DataSet -> int

abstract member Update : System.Data.DataSet -> int

Public Overridable Function Update (dataSet As DataSet) As Integer

Public MustOverride Function Update (dataSet As DataSet) As Integer

Parameter

Gibt zurück

Die Anzahl der Zeilen wurde erfolgreich aus dem DataSet.

Implementiert

Attribute

RequiresUnreferencedCodeAttribute

Ausnahmen

Beispiele

Im folgenden Beispiel wird die abgeleitete Klasse ( OleDbDataAdapter) für Update die Datenquelle verwendet.

static private DataSet CreateCommandAndUpdate(
    string connectionString,
    string queryString)
{
    DataSet dataSet = new DataSet();

    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbDataAdapter adapter =
            new OleDbDataAdapter();
        adapter.SelectCommand =
            new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder =
            new OleDbCommandBuilder(adapter);

        adapter.Fill(dataSet);

        // Code to modify data in the DataSet here.

        // Without the OleDbCommandBuilder, this line would fail.
        adapter.UpdateCommand = builder.GetUpdateCommand();
        adapter.Update(dataSet);
    }
    return dataSet;
}

Public Function CreateCommandAndUpdate( _
    ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim adapter As New OleDbDataAdapter()

        adapter.SelectCommand = New OleDbCommand( _
            queryString, connection)

        Dim builder As OleDbCommandBuilder = _
            New OleDbCommandBuilder(adapter)

        adapter.Fill(dataSet)

        ' Code to modify the data in the DataSet here. 

        ' Without the OleDbCommandBuilder this line would fail.
        builder.GetUpdateCommand()
        adapter.Update(dataSet)
    End Using
    Return dataSet
End Function

Hinweise

Die Aktualisierung erfolgt nach Zeile. Für jede eingefügte, geänderte und gelöschte Zeile bestimmt die Update Methode den Typ der darin ausgeführten Änderung (Einfügen, Aktualisieren oder Löschen). Je nach Änderungstyp wird die Befehlsvorlage Update,Delete oder die InsertBefehlsvorlage ausgeführt, um die geänderte Zeile an die Datenquelle zu verteilen. Wenn eine Anwendung die Update Methode aufruftRowState, überprüft die DataAdapter Eigenschaft und führt die erforderlichen INSERT-, UPDATE- oder DELETE-Anweisungen iterativ für jede Zeile aus, basierend auf der Reihenfolge der in der DataSetDatei konfigurierten Indizes. Beispielsweise Update kann eine DELETE-Anweisung, gefolgt von einer INSERT-Anweisung, und dann eine andere DELETE-Anweisung ausgeführt werden, aufgrund der Reihenfolge der Zeilen in der DataTable.

Es ist zu beachten, dass diese Anweisungen nicht als Batchprozess ausgeführt werden; Jede Zeile wird einzeln aktualisiert. Eine Anwendung kann die GetChanges Methode in Situationen aufrufen, in denen Sie die Reihenfolge der Anweisungstypen steuern müssen (z. B. INSERT vor UPDATE). Weitere Informationen finden Sie unter Aktualisieren von Datenquellen mit DataAdapters.

Wenn INSERT-, UPDATE- oder DELETE-Anweisungen nicht angegeben wurden, generiert die Update Methode eine Ausnahme. Sie können jedoch ein SqlCommandBuilder Objekt OleDbCommandBuilder erstellen, um SQL-Anweisungen für Aktualisierungen mit einer einzelnen Tabelle automatisch zu generieren, wenn Sie die SelectCommand Eigenschaft eines .NET Framework-Datenanbieters festlegen. Anschließend werden alle zusätzlichen SQL-Anweisungen, die Sie nicht festlegen, vom CommandBuilder generiert. Diese Generierungslogik erfordert, dass wichtige Spalteninformationen in der DataSet. Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilders.

Die Update Methode ruft Zeilen aus der Tabelle ab, die in der ersten Zuordnung aufgeführt sind, bevor eine Aktualisierung ausgeführt wird. Aktualisiert Update dann die Zeile mithilfe des Werts der UpdatedRowSource Eigenschaft. Alle zurückgegebenen zusätzlichen Zeilen werden ignoriert.

Nachdem daten wieder in das DataSetEreignis geladen wurden, wird das OnRowUpdated Ereignis ausgelöst, sodass der Benutzer die abgeglichene DataSet Zeile und alle vom Befehl zurückgegebenen Ausgabeparameter prüfen kann. Nachdem eine Zeile erfolgreich aktualisiert wurde, werden die Änderungen an dieser Zeile akzeptiert.

Bei Verwendung Updatelautet die Reihenfolge der Ausführung wie folgt:

1. Die Werte in der Datei DataRow werden in die Parameterwerte verschoben.

2. Das OnRowUpdating-Ereignis wird ausgelöst.

3. Der Befehl wird ausgeführt.

4. Wenn der Befehl auf .

5. Wenn Ausgabeparameter vorhanden sind, werden sie in der DataRow.

6. Das OnRowUpdated-Ereignis wird ausgelöst.

7. DataRow.AcceptChanges wird aufgerufen. Dadurch werden sowohl die Ereignisse als DataTable.RowChanged auch die DataTable.RowChanging Ereignisse für die aktualisierte .DataRow

Jedem Befehl, der der DataAdapter Regel zugeordnet ist, ist eine Parameterauflistung zugeordnet. Parameter werden der aktuellen Zeile über die Eigenschaften SourceVersion und Eigenschaften SourceColumn einer .NET-Datenanbieterklasse Parameter zugeordnet. SourceColumn bezieht sich auf eine DataTable Spalte, auf die die Verweise zum Abrufen von DataAdapter Parameterwerten für die aktuelle Zeile verweist.

SourceColumn bezieht sich auf den Nicht zugeordneten Spaltennamen, bevor Tabellenzuordnungen angewendet wurden. Wenn SourceColumn sich auf eine nicht vorhandene Spalte bezieht, hängt die ausgeführte Aktion von einem der folgenden MissingMappingAction Werte ab.

Die SourceColumn Eigenschaft wird auch verwendet, um den Wert für Ausgabe- oder Eingabe-/Ausgabeparameter wieder dem DataSetzuordnen. Eine Ausnahme wird generiert, wenn sie sich auf eine nicht vorhandene Spalte bezieht.

Die SourceVersion Eigenschaft der .NET-Datenanbieterklasse Parameter bestimmt, ob die Original-, Current- oder Proposed-Version des Spaltenwerts verwendet werden soll. Diese Funktion wird häufig verwendet, um originale Werte in die WHERE-Klausel einer UPDATE-Anweisung einzuschließen, um auf optimistische Parallelitätsverletzungen zu überprüfen.

Durch Aufrufen der AcceptChanges Methode oder AcceptChanges Methode werden alle Änderungen in der oder .DataSetDataTable Wenn eine dieser Methoden aufgerufen wird, bevor die Update Methode aufgerufen wird, werden beim Aufrufen der Update Methode keine Änderungen übernommen, es sei denn, weitere Änderungen wurden seit AcceptChanges oder AcceptChanges aufgerufen.

Weitere Informationen

• Übersicht über ADO.NET