IDataAdapter.Update(DataSet) Methode

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

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

public 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

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

Public Function Update (dataSet As DataSet) As Integer

Parameter

Gibt zurück

Die Anzahl der Zeilen wurde erfolgreich aus dem DataSet.

Attribute

RequiresUnreferencedCodeAttribute

Ausnahmen

Beispiele

Im folgenden Beispiel wird die abgeleitete Klasse ( OleDbDataAdapter) für Update die Datenquelle verwendet. In diesem Beispiel wird davon ausgegangen, dass Sie ein OleDbDataAdapter und ein DataSet.

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

Wenn eine Anwendung die Update Methode aufruftRowState, überprüft die IDataAdapter 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.

Beachten Sie, dass diese Anweisungen nicht als Batchprozess ausgeführt werden; Jede Zeile wird einzeln aktualisiert. Eine Anwendung kann die GetChanges Methode aufrufen, wenn Sie die Reihenfolge der Anweisungstypen steuern müssen (z. B. INSERTs vor UPDATEs). 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 FirstReturnedRecord festgelegt ist, wird das erste zurückgegebene Ergebnis in das DataRow.

5. Wenn Ausgabeparameter vorhanden sind, werden sie in der DataRowDatei abgelegt.

6. Das OnRowUpdated-Ereignis wird ausgelöst.

7. AcceptChanges wird aufgerufen.

Jedem Befehl, der der IDataAdapter Regel zugeordnet ist, ist eine Parameterauflistung zugeordnet. Parameter werden der aktuellen Zeile über die SourceColumn Eigenschaften und SourceVersion Eigenschaften einer .NET Framework-Datenanbieterklasse Parameter zugeordnet. SourceColumn bezieht sich auf eine DataTable Spalte, auf die die Verweise zum Abrufen von IDataAdapter 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 einer .NET Framework-Datenanbieterklasse Parameter bestimmt, ob der Spaltenwert oder Proposed die OriginalCurrentVersion 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.