DbDataAdapter.Update Methode

Referenz

Definition

Namespace:: System.Data.Common

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Aktualisiert die Werte in der Datenbank, indem die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile in der DataSetausgeführt werden.

Überlädt

Update(DataSet, String)	Aktualisiert die Werte in der Datenbank, indem die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile im DataSet mit dem angegebenen DataTable Namen ausgeführt werden.
Update(DataRow[], DataTableMapping)	Aktualisiert die Werte in der Datenbank, indem die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen Array von DataRow Objekten ausgeführt werden.
Update(DataTable)	Aktualisiert die Werte in der Datenbank, indem die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile in der angegebenen DataTableausgeführt werden.
Update(DataSet)	Aktualisiert die Werte in der Datenbank, indem die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile in der angegebenen DataSetausgeführt werden.
Update(DataRow[])	Aktualisiert die Werte in der Datenbank, indem die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen Array in der DataSetausgeführt werden.

Update(DataSet, String)

Quelle:: DbDataAdapter.cs

Quelle:: DbDataAdapter.cs

Quelle:: DbDataAdapter.cs

Aktualisiert die Werte in der Datenbank, indem die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile im DataSet mit dem angegebenen DataTable Namen ausgeführt werden.

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

public int Update (System.Data.DataSet dataSet, string srcTable);

override this.Update : System.Data.DataSet * string -> int

Public Function Update (dataSet As DataSet, srcTable As String) As Integer

Parameter

dataSet: DataSet

Die DataSet, die zum Aktualisieren der Datenquelle verwendet werden sollen.

srcTable: String

Der Name der Quelltabelle, die für die Tabellenzuordnung verwendet werden soll.

Gibt zurück

Int32

Die Anzahl der Zeilen wurde erfolgreich aus dem DataSetaktualisiert.

Ausnahmen

ArgumentNullException

Die DataSet ist ungültig.

InvalidOperationException

Die Quelltabelle ist ungültig.

DBConcurrencyException

Ein Versuch, eine INSERT-, UPDATE- oder DELETE-Anweisung auszuführen, hat zu null Datensätzen geführt, die betroffen sind.

Beispiele

Im folgenden Beispiel wird die abgeleitete Klasse OleDbDataAdapterverwendet, um die Datenquelle zu aktualisieren.

public DataSet CreateCmdsAndUpdate(string connectionString,
    string queryString, string tableName)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        adapter.Update(customers, tableName);

        return customers;
    }
}

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

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As New DataSet()
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        adapter.Update(customers, tableName)

        Return customers
    End Using
End Function

Hinweise

Wenn eine Anwendung die Update-Methode aufruft, überprüft die DbDataAdapter die RowState-Eigenschaft und führt die erforderlichen INSERT-, UPDATE- oder DELETE-Anweisungen für jede Zeile iterativ aus, basierend auf der Reihenfolge der in der DataSetkonfigurierten Indizes. Beispielsweise kann Update eine DELETE-Anweisung, gefolgt von einer INSERT-Anweisung, und dann eine andere DELETE-Anweisung ausführen, 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- oder OleDbCommandBuilder-Objekt 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 im DataSetvorhanden sind. Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilders.

Die Update-Methode unterstützt Szenarien, in denen die DataSet mehrere DataTable Objekte enthält, deren Namen nur nach Groß-/Kleinschreibung abweichen. Wenn in einem DataSetmehrere Tabellen mit demselben Namen vorhanden sind, führt Update einen Vergleich zwischen Groß- und Kleinschreibung durch, um die entsprechende Tabelle zu finden, und generiert eine Ausnahme, wenn keine genaue Übereinstimmung vorhanden ist. Der folgende C#-Code veranschaulicht dieses Verhalten.

DataSet ds = new DataSet();  
 ds.Tables.Add("aaa");  
 ds.Tables.Add("AAA");  
 adapter.Update(ds, "aaa"); // Updates "aaa", which already exists in the DataSet.  
 adapter.Update(ds, "AAA"); // Updates "AAA", which already exists in the DataSet.  
    adapter.Update(ds, "Aaa"); // Results in an exception.

Wenn Update aufgerufen wird und die DataSet nur eine DataTable enthält, deren Name nur im Fall unterschiedlich ist, wird diese DataTable aktualisiert. In diesem Szenario wird die Groß-/Kleinschreibung nicht beachtet. Der folgende C#-Code veranschaulicht dieses Verhalten.

DataSet dataset = new DataSet();  
 dataset.Tables.Add("aaa");  
    adapter.Update(dataset, "AAA"); // Updates table "aaa" because only one similarly named table is in the DataSet.

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

Nachdem daten wieder in die DataSetgeladen wurden, wird das OnRowUpdated-Ereignis ausgelöst, sodass der Benutzer die abgeglichenen 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 von Updatelautet die Ausführungsreihenfolge wie folgt:

Die Werte im DataRow werden in die Parameterwerte verschoben.
Das OnRowUpdating-Ereignis wird ausgelöst.
Der Befehl wird ausgeführt.
Wenn der Befehl auf FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.
Wenn Ausgabeparameter vorhanden sind, werden sie in der DataRowplatziert.
Das OnRowUpdated-Ereignis wird ausgelöst.
AcceptChanges wird aufgerufen.

Jeder befehl, der dem DbDataAdapter zugeordnet ist, weist in der Regel eine Parameterauflistung auf. Parameter werden der aktuellen Zeile über die SourceColumn und SourceVersion Eigenschaften der Parameter Klasse eines .NET Framework-Datenanbieters zugeordnet. SourceColumn bezieht sich auf eine DataTable Spalte, auf die die DbDataAdapter verweist, um Parameterwerte für die aktuelle Zeile abzurufen.

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

Enumerationswert	Ergriffene Maßnahmen
`MissingMappingAction.Passthrough`	Verwenden Sie die Quellspaltennamen und Tabellennamen im DataSet, wenn keine Zuordnung vorhanden ist.
`MissingMappingAction.Ignore`	Eine SystemException wird generiert. Wenn die Zuordnungen explizit festgelegt werden, ist eine fehlende Zuordnung für einen Eingabeparameter in der Regel das Ergebnis eines Fehlers.
`MissingMappingAction.Error`	Eine SystemException wird generiert.

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

Die SourceVersion Eigenschaft der Parameter-Klasse eines .NET Framework-Datenanbieters 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.

Anmerkung

Wenn beim Aktualisieren einer Zeile ein Fehler auftritt, wird eine Ausnahme ausgelöst, und die Ausführung des Updates wird nicht mehr ausgeführt. Wenn Sie den Aktualisierungsvorgang fortsetzen möchten, ohne Ausnahmen zu generieren, wenn ein Fehler auftritt, legen Sie die eigenschaft ContinueUpdateOnError auf true fest, bevor Sie Updateaufrufen. Sie können auch auf Fehler pro Zeile innerhalb des RowUpdated Ereignisses eines DataAdapter reagieren. Um den Aktualisierungsvorgang fortzusetzen, ohne eine Ausnahme innerhalb des RowUpdated-Ereignisses zu generieren, legen Sie die Status-Eigenschaft des RowUpdatedEventArgs auf Continuefest.

Weitere Informationen

Gilt für:

Update(DataRow[], DataTableMapping)

Quelle:: DbDataAdapter.cs

Quelle:: DbDataAdapter.cs

Quelle:: DbDataAdapter.cs

Aktualisiert die Werte in der Datenbank, indem die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen Array von DataRow Objekten ausgeführt werden.

protected:
 virtual int Update(cli::array <System::Data::DataRow ^> ^ dataRows, System::Data::Common::DataTableMapping ^ tableMapping);

protected virtual int Update (System.Data.DataRow[] dataRows, System.Data.Common.DataTableMapping tableMapping);

override this.Update : System.Data.DataRow[] * System.Data.Common.DataTableMapping -> int

Protected Overridable Function Update (dataRows As DataRow(), tableMapping As DataTableMapping) As Integer

Parameter

dataRows: DataRow[]

Ein Array von DataRow Objekten, die zum Aktualisieren der Datenquelle verwendet werden.

tableMapping: DataTableMapping

Die zu verwendende TableMappings Auflistung.

Gibt zurück

Int32

Die Anzahl der Zeilen wurde erfolgreich aus dem Array DataRow Objekte aktualisiert.

Ausnahmen

ArgumentNullException

Die DataSet ist ungültig.

InvalidOperationException

Die Quelltabelle ist ungültig.

SystemException

Es ist keine DataRow zum Aktualisieren vorhanden.

-oder-

Es ist keine DataTable zum Aktualisieren vorhanden.

-oder-

Es ist keine DataSet vorhanden, die als Quelle verwendet werden sollen.

DBConcurrencyException

Ein Versuch, eine INSERT-, UPDATE- oder DELETE-Anweisung auszuführen, hat zu null Datensätzen geführt, die betroffen sind.

Hinweise

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. INSERTs vor UPDATEs). Weitere Informationen finden Sie unter Aktualisieren von Datenquellen mit DataAdapters.

Bei verwendung von Updatelautet die Ausführungsreihenfolge wie folgt:

Die Werte im DataRow werden in die Parameterwerte verschoben.
Das OnRowUpdating-Ereignis wird ausgelöst.
Der Befehl wird ausgeführt.
Wenn der Befehl auf FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.
Wenn Ausgabeparameter vorhanden sind, werden sie in der DataRowplatziert.
Das OnRowUpdated-Ereignis wird ausgelöst.
AcceptChanges wird aufgerufen.

Enumerationswert	Ergriffene Maßnahmen
`MissingMappingAction.Passthrough`	Verwenden Sie die Quellspaltennamen und Tabellennamen im DataSet, wenn keine Zuordnung vorhanden ist.
`MissingMappingAction.Ignore`	Eine SystemException wird generiert. Wenn die Zuordnungen explizit festgelegt werden, ist eine fehlende Zuordnung für einen Eingabeparameter in der Regel das Ergebnis eines Fehlers.
`MissingMappingAction.Error`	Eine SystemException wird generiert.

Anmerkung

Weitere Informationen

Gilt für:

Update(DataTable)

Quelle:: DbDataAdapter.cs

Quelle:: DbDataAdapter.cs

Quelle:: DbDataAdapter.cs

Aktualisiert die Werte in der Datenbank, indem die entsprechenden INSERT-, UPDATE- oder DELETE-Anweisungen für jede eingefügte, aktualisierte oder gelöschte Zeile in der angegebenen DataTableausgeführt werden.

public:
 int Update(System::Data::DataTable ^ dataTable);

public int Update (System.Data.DataTable dataTable);

override this.Update : System.Data.DataTable -> int

Public Function Update (dataTable As DataTable) As Integer

Parameter

dataTable: DataTable

Die zum Aktualisieren der Datenquelle verwendete DataTable.

Gibt zurück

Int32

Die Anzahl der Zeilen wurde erfolgreich aus dem DataTableaktualisiert.

Ausnahmen

ArgumentNullException

Die DataSet ist ungültig.

InvalidOperationException

Die Quelltabelle ist ungültig.

SystemException

Es ist keine DataRow zum Aktualisieren vorhanden.

-oder-

Es ist keine DataTable zum Aktualisieren vorhanden.

-oder-

Es ist keine DataSet vorhanden, die als Quelle verwendet werden sollen.

DBConcurrencyException

Ein Versuch, eine INSERT-, UPDATE- oder DELETE-Anweisung auszuführen, hat zu null Datensätzen geführt, die betroffen sind.

Beispiele

Im folgenden Beispiel wird die abgeleitete Klasse OleDbDataAdapterverwendet, um die Datenquelle zu aktualisieren.

public DataTable CreateCmdsAndUpdate(string connectionString,
    string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataTable customers = new DataTable();
        adapter.Fill(customers);

        // code to modify data in DataTable here

        adapter.Update(customers);

        return customers;
    }
}

Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
    ByVal queryString As String) As DataTable

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As New DataTable()
        adapter.Fill(customers)

        ' Code to modify data in DataTable here 

        adapter.Update(customers)
        Return customers
    End Using
End Function

Hinweise

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. INSERTs vor UPDATEs). Weitere Informationen finden Sie unter Aktualisieren von Datenquellen mit DataAdapters.

Bei verwendung von Updatelautet die Ausführungsreihenfolge wie folgt:

Die Werte im DataRow werden in die Parameterwerte verschoben.
Das OnRowUpdating-Ereignis wird ausgelöst.
Der Befehl wird ausgeführt.
Wenn der Befehl auf FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.
Wenn Ausgabeparameter vorhanden sind, werden sie in der DataRowplatziert.
Das OnRowUpdated-Ereignis wird ausgelöst.
AcceptChanges wird aufgerufen.

Enumerationswert	Ergriffene Maßnahmen
`MissingMappingAction.Passthrough`	Verwenden Sie die Quellspaltennamen und Tabellennamen im DataSet, wenn keine Zuordnung vorhanden ist.
`MissingMappingAction.Ignore`	Eine SystemException wird generiert. Wenn die Zuordnungen explizit festgelegt werden, ist eine fehlende Zuordnung für einen Eingabeparameter in der Regel das Ergebnis eines Fehlers.
`MissingMappingAction.Error`	Eine SystemException wird generiert.

Anmerkung

Weitere Informationen

Gilt für:

Update(DataSet)

Quelle:: DbDataAdapter.cs

Quelle:: DbDataAdapter.cs

Quelle:: DbDataAdapter.cs

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

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

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

Public Overrides Function Update (dataSet As DataSet) As Integer

Parameter

dataSet: DataSet

Die zum Aktualisieren der Datenquelle verwendete DataSet.

Gibt zurück

Int32

Die Anzahl der Zeilen wurde erfolgreich aus dem DataSetaktualisiert.

Implementiert

Update(DataSet)

Ausnahmen

InvalidOperationException

Die Quelltabelle ist ungültig.

DBConcurrencyException

Ein Versuch, eine INSERT-, UPDATE- oder DELETE-Anweisung auszuführen, hat zu null Datensätzen geführt, die betroffen sind.

Beispiele

Im folgenden Beispiel wird die abgeleitete Klasse OleDbDataAdapterverwendet, um die Datenquelle zu aktualisieren.

public DataSet CreateCmdsAndUpdate(string connectionString,
    string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        adapter.Update(customers);

        return customers;
    }
}

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

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As New DataSet()
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        adapter.Update(customers)

        Return customers
    End Using
End Function

Hinweise

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. INSERTs vor UPDATEs). Weitere Informationen finden Sie unter Aktualisieren von Datenquellen mit DataAdapters.

Bei verwendung von Updatelautet die Ausführungsreihenfolge wie folgt:

Die Werte im DataRow werden in die Parameterwerte verschoben.
Das OnRowUpdating-Ereignis wird ausgelöst.
Der Befehl wird ausgeführt.
Wenn der Befehl auf FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.
Wenn Ausgabeparameter vorhanden sind, werden sie in der DataRowplatziert.
Das OnRowUpdated-Ereignis wird ausgelöst.
AcceptChanges wird aufgerufen.

Enumerationswert	Ergriffene Maßnahmen
`MissingMappingAction.Passthrough`	Verwenden Sie die Quellspaltennamen und Tabellennamen im DataSet, wenn keine Zuordnung vorhanden ist.
`MissingMappingAction.Ignore`	Eine SystemException wird generiert. Wenn die Zuordnungen explizit festgelegt werden, ist eine fehlende Zuordnung für einen Eingabeparameter in der Regel das Ergebnis eines Fehlers.
`MissingMappingAction.Error`	Eine SystemException wird generiert.

Anmerkung

Weitere Informationen

Gilt für:

Update(DataRow[])

Quelle:: DbDataAdapter.cs

Quelle:: DbDataAdapter.cs

Quelle:: DbDataAdapter.cs

public:
 int Update(cli::array <System::Data::DataRow ^> ^ dataRows);

public int Update (System.Data.DataRow[] dataRows);

override this.Update : System.Data.DataRow[] -> int

Public Function Update (dataRows As DataRow()) As Integer

Parameter

dataRows: DataRow[]

Ein Array von DataRow Objekten, die zum Aktualisieren der Datenquelle verwendet werden.

Gibt zurück

Int32

Die Anzahl der Zeilen wurde erfolgreich aus dem DataSetaktualisiert.

Ausnahmen

ArgumentNullException

Die DataSet ist ungültig.

InvalidOperationException

Die Quelltabelle ist ungültig.

SystemException

Es ist keine DataRow zum Aktualisieren vorhanden.

-oder-

Es ist keine DataTable zum Aktualisieren vorhanden.

-oder-

Es ist keine DataSet vorhanden, die als Quelle verwendet werden sollen.

DBConcurrencyException

Ein Versuch, eine INSERT-, UPDATE- oder DELETE-Anweisung auszuführen, hat zu null Datensätzen geführt, die betroffen sind.

Beispiele

Im folgenden Beispiel wird die abgeleitete Klasse OleDbDataAdapterverwendet, um die Datenquelle zu aktualisieren.

public DataSet CreateCmdsAndUpdate(string connectionString,
    string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        //Insert new records from DataSet
        DataRow[] rows = customers.Tables[0].Select(
            null, null, DataViewRowState.Added);
        adapter.Update(rows);

        return customers;
    }
}

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

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As New DataSet()
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        ' Insert new records from DataSet
        Dim rows() As DataRow = customers.Tables(0).Select( _
            Nothing, Nothing, DataViewRowState.Added)
        adapter.Update(rows)

        Return customers
    End Using
End Function

Hinweise

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. INSERTs vor UPDATEs). Weitere Informationen finden Sie unter Aktualisieren von Datenquellen mit DataAdapters.

Bei verwendung von Updatelautet die Ausführungsreihenfolge wie folgt:

Die Werte im DataRow werden in die Parameterwerte verschoben.
Das OnRowUpdating-Ereignis wird ausgelöst.
Der Befehl wird ausgeführt.
Wenn der Befehl auf FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.
Wenn Ausgabeparameter vorhanden sind, werden sie in der DataRowplatziert.
Das OnRowUpdated-Ereignis wird ausgelöst.
AcceptChanges wird aufgerufen.

Enumerationswert	Ergriffene Maßnahmen
`MissingMappingAction.Passthrough`	Verwenden Sie die Quellspaltennamen und Tabellennamen im DataSet, wenn keine Zuordnung vorhanden ist.
`MissingMappingAction.Ignore`	Eine SystemException wird generiert. Wenn die Zuordnungen explizit festgelegt werden, ist eine fehlende Zuordnung für einen Eingabeparameter in der Regel das Ergebnis eines Fehlers.
`MissingMappingAction.Error`	Eine SystemException wird generiert.

Anmerkung

Weitere Informationen

Gilt für:

Freigeben über

DbDataAdapter.Update Methode

Definition

Überlädt

Update(DataSet, String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Update(DataRow[], DataTableMapping)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Update(DataTable)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Update(DataSet)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Update(DataRow[])

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen