Freigeben über


DbDataAdapter.Update Methode

Definition

Aktualisiert die Werte in der Datenbank, indem für jede eingefügte, aktualisierte oder gelöschte Zeile im DataSet die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung ausgeführt werden.

Überlädt

Update(DataSet, String)

Aktualisiert die Werte in der Datenbank, indem es die jeweiligen Anweisungen „Einfügen“, „Aktualisieren“ oder „Löschen“ für jede eingefügte, aktualisierte oder gelöschte Zeile in dem DataSet mit dem angegebenen DataTable-Namen ausführt.

Update(DataRow[], DataTableMapping)

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

Update(DataTable)

Aktualisiert die Werte in der Datenbank, indem für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen DataTable die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung ausgeführt werden.

Update(DataSet)

Aktualisiert die Werte in der Datenbank, indem für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen DataSet die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung ausgeführt werden.

Update(DataRow[])

Aktualisiert die Werte in der Datenbank, indem für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen Array in DataSet die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung ausgeführt werden.

Update(DataSet, String)

Quelle:
DbDataAdapter.cs
Quelle:
DbDataAdapter.cs
Quelle:
DbDataAdapter.cs

Aktualisiert die Werte in der Datenbank, indem es die jeweiligen Anweisungen „Einfügen“, „Aktualisieren“ oder „Löschen“ für jede eingefügte, aktualisierte oder gelöschte Zeile in dem DataSet mit dem angegebenen DataTable-Namen ausführt.

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

Das zum Aktualisieren der Datenquelle zu verwendende DataSet.

srcTable
String

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

Gibt zurück

Die Anzahl der erfolgreich aktualisierten Zeilen im DataSet.

Ausnahmen

Die Quelltabelle ist ungültig.

Der Versuch, eine INSERT-Anweisung, UPDATE-Anweisung oder DELETE-Anweisung auszuführen, ergab 0 (null) betroffene Datensätze.

Beispiele

Im folgenden Beispiel wird die abgeleitete Klasse verwendet, OleDbDataAdapterum 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, DbDataAdapter überprüft die RowState -Eigenschaft und führt die erforderlichen INSERT-, UPDATE- oder DELETE-Anweisungen iterativ für jede Zeile aus, basierend auf der Reihenfolge der in DataSetkonfigurierten Indizes. Beispielsweise Update kann aufgrund der Reihenfolge der Zeilen im eine DELETE-Anweisung gefolgt von einer INSERT-Anweisung und dann eine weitere DELETE-Anweisung ausgeführt werden 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 - oder OleDbCommandBuilder -SqlCommandBuilderObjekt erstellen, um SQL-Anweisungen für Einzeltabellenupdates 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 mehrere DataSetDataTable Objekte enthält, deren Namen sich nur nach Groß-/Kleinschreibung unterscheiden. Wenn mehrere Tabellen mit dem gleichen Namen, aber unterschiedlicher Groß-/Kleinschreibung in einem DataSetvorhanden sind, Update führt 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 nur DataSet einen DataTable enthält, dessen Name sich nur nach Groß- und Kleinschreibung unterscheidet, wird dieser DataTable aktualisiert. In diesem Szenario wird beim Vergleich 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 ist, bevor ein Update ausgeführt wird. Aktualisiert Update dann die Zeile mithilfe des Werts der UpdatedRowSource -Eigenschaft. Alle zusätzlichen zurückgegebenen Zeilen werden ignoriert.

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

Bei Verwendung Updatevon lautet die Ausführungsreihenfolge wie folgt:

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

  2. Das OnRowUpdating-Ereignis wird ausgelöst.

  3. Der Befehl wird ausgeführt.

  4. Wenn der Befehl auf FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.

  5. Wenn Ausgabeparameter vorhanden sind, werden sie im DataRowplatziert.

  6. Das OnRowUpdated-Ereignis wird ausgelöst.

  7. AcceptChanges wird aufgerufen.

Jedem Befehl, der zugeordnet ist, ist in der DbDataAdapter Regel eine Parameterauflistung zugeordnet. Parameter werden der aktuellen Zeile über die SourceColumn Eigenschaften und SourceVersion einer .NET Framework-Datenanbieterklasse Parameter zugeordnet. SourceColumn verweist auf eine DataTable Spalte, auf die verwiesen DbDataAdapter wird, um Parameterwerte für die aktuelle Zeile abzurufen.

SourceColumn verweist auf den namen der nicht zugeordneten Spalte, 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 Ausgeführte Aktion
MissingMappingAction.Passthrough Verwenden Sie die Quellspaltennamen und Tabellennamen in, DataSet wenn keine Zuordnung vorhanden ist.
MissingMappingAction.Ignore Ein 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 Ein 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 auf eine nicht vorhandene Spalte verweist.

Die SourceVersion -Eigenschaft einer .NET Framework-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 Verstöße gegen die optimistische Parallelität zu überprüfen.

Hinweis

Wenn beim Aktualisieren einer Zeile ein Fehler auftritt, wird eine Ausnahme ausgelöst, und die Ausführung des Updates wird eingestellt. Um den Aktualisierungsvorgang fortzusetzen, ohne Ausnahmen zu generieren, wenn ein Fehler auftritt, legen Sie die ContinueUpdateOnError -Eigenschaft auf fest true , bevor Sie aufrufen Update. Sie können auch auf Fehler pro Zeile innerhalb des RowUpdated DataAdapter-Ereignisses reagieren. Um den Aktualisierungsvorgang fortzusetzen, ohne eine Ausnahme innerhalb des RowUpdated Ereignisses zu generieren, legen Sie die Status -Eigenschaft von RowUpdatedEventArgs auf fest Continue.

Weitere Informationen

Gilt für:

Update(DataRow[], DataTableMapping)

Quelle:
DbDataAdapter.cs
Quelle:
DbDataAdapter.cs
Quelle:
DbDataAdapter.cs

Aktualisiert die Werte in der Datenbank, indem für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen Array von DataRow-Objekten die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung 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, mit denen die Datenquelle aktualisiert wird.

tableMapping
DataTableMapping

Die zu verwendende TableMappings-Auflistung.

Gibt zurück

Die Anzahl der Zeilen, die erfolgreich aus dem Array von DataRow -Objekten aktualisiert wurden.

Ausnahmen

Die Quelltabelle ist ungültig.

Es ist keine zu aktualisierende DataRow vorhanden.

- oder -

Es ist keine zu aktualisierende DataTable vorhanden.

- oder -

Es ist kein DataSet vorhanden, das als Quelle verwendet werden kann.

Der Versuch, eine INSERT-Anweisung, UPDATE-Anweisung oder DELETE-Anweisung auszuführen, ergab 0 (null) betroffene Datensätze.

Hinweise

Wenn eine Anwendung die Update -Methode aufruft, DbDataAdapter überprüft die RowState -Eigenschaft und führt die erforderlichen INSERT-, UPDATE- oder DELETE-Anweisungen iterativ für jede Zeile aus, basierend auf der Reihenfolge der in DataSetkonfigurierten Indizes. Beispielsweise Update kann aufgrund der Reihenfolge der Zeilen im eine DELETE-Anweisung gefolgt von einer INSERT-Anweisung und dann eine weitere DELETE-Anweisung ausgeführt werden 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. 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 - oder OleDbCommandBuilder -SqlCommandBuilderObjekt erstellen, um SQL-Anweisungen für Einzeltabellenupdates 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 ruft Zeilen aus der Tabelle ab, die in der ersten Zuordnung aufgeführt ist, bevor ein Update ausgeführt wird. Aktualisiert Update dann die Zeile mithilfe des Werts der UpdatedRowSource -Eigenschaft. Alle zusätzlichen zurückgegebenen Zeilen werden ignoriert.

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

Bei Verwendung Updatevon lautet die Ausführungsreihenfolge wie folgt:

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

  2. Das OnRowUpdating-Ereignis wird ausgelöst.

  3. Der Befehl wird ausgeführt.

  4. Wenn der Befehl auf FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.

  5. Wenn Ausgabeparameter vorhanden sind, werden sie im DataRowplatziert.

  6. Das OnRowUpdated-Ereignis wird ausgelöst.

  7. AcceptChanges wird aufgerufen.

Jedem Befehl, der zugeordnet ist, ist in der DbDataAdapter Regel eine Parameterauflistung zugeordnet. Parameter werden der aktuellen Zeile über die SourceColumn Eigenschaften und SourceVersion einer .NET Framework-Datenanbieterklasse Parameter zugeordnet. SourceColumn verweist auf eine DataTable Spalte, auf die verwiesen DbDataAdapter wird, um Parameterwerte für die aktuelle Zeile abzurufen.

SourceColumn verweist auf den namen der nicht zugeordneten Spalte, 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 Ausgeführte Aktion
MissingMappingAction.Passthrough Verwenden Sie die Quellspaltennamen und Tabellennamen in, DataSet wenn keine Zuordnung vorhanden ist.
MissingMappingAction.Ignore Ein 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 Ein 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 auf eine nicht vorhandene Spalte verweist.

Die SourceVersion -Eigenschaft einer .NET Framework-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 Verstöße gegen die optimistische Parallelität zu überprüfen.

Hinweis

Wenn beim Aktualisieren einer Zeile ein Fehler auftritt, wird eine Ausnahme ausgelöst, und die Ausführung des Updates wird eingestellt. Um den Aktualisierungsvorgang fortzusetzen, ohne Ausnahmen zu generieren, wenn ein Fehler auftritt, legen Sie die ContinueUpdateOnError -Eigenschaft auf fest true , bevor Sie aufrufen Update. Sie können auch auf Fehler pro Zeile innerhalb des RowUpdated DataAdapter-Ereignisses reagieren. Um den Aktualisierungsvorgang fortzusetzen, ohne eine Ausnahme innerhalb des RowUpdated Ereignisses zu generieren, legen Sie die Status -Eigenschaft von RowUpdatedEventArgs auf fest Continue.

Weitere Informationen

Gilt für:

Update(DataTable)

Quelle:
DbDataAdapter.cs
Quelle:
DbDataAdapter.cs
Quelle:
DbDataAdapter.cs

Aktualisiert die Werte in der Datenbank, indem für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen DataTable die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung ausgefü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 DataTable, mit der die Datenquelle aktualisiert wird.

Gibt zurück

Die Anzahl der erfolgreich aktualisierten Zeilen im DataTable.

Ausnahmen

Die Quelltabelle ist ungültig.

Es ist keine zu aktualisierende DataRow vorhanden.

- oder -

Es ist keine zu aktualisierende DataTable vorhanden.

- oder -

Es ist kein DataSet vorhanden, das als Quelle verwendet werden kann.

Der Versuch, eine INSERT-Anweisung, UPDATE-Anweisung oder DELETE-Anweisung auszuführen, ergab 0 (null) betroffene Datensätze.

Beispiele

Im folgenden Beispiel wird die abgeleitete Klasse verwendet, OleDbDataAdapterum 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

Wenn eine Anwendung die Update -Methode aufruft, DbDataAdapter überprüft die RowState -Eigenschaft und führt die erforderlichen INSERT-, UPDATE- oder DELETE-Anweisungen iterativ für jede Zeile aus, basierend auf der Reihenfolge der in DataSetkonfigurierten Indizes. Beispielsweise Update kann aufgrund der Reihenfolge der Zeilen im eine DELETE-Anweisung gefolgt von einer INSERT-Anweisung und dann eine weitere DELETE-Anweisung ausgeführt werden 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. 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 - oder OleDbCommandBuilder -SqlCommandBuilderObjekt erstellen, um SQL-Anweisungen für Einzeltabellenupdates 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 ruft Zeilen aus der Tabelle ab, die in der ersten Zuordnung aufgeführt ist, bevor ein Update ausgeführt wird. Aktualisiert Update dann die Zeile mithilfe des Werts der UpdatedRowSource -Eigenschaft. Alle zusätzlichen zurückgegebenen Zeilen werden ignoriert.

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

Bei Verwendung Updatevon lautet die Ausführungsreihenfolge wie folgt:

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

  2. Das OnRowUpdating-Ereignis wird ausgelöst.

  3. Der Befehl wird ausgeführt.

  4. Wenn der Befehl auf FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.

  5. Wenn Ausgabeparameter vorhanden sind, werden sie im DataRowplatziert.

  6. Das OnRowUpdated-Ereignis wird ausgelöst.

  7. AcceptChanges wird aufgerufen.

Jedem Befehl, der zugeordnet ist, ist in der DbDataAdapter Regel eine Parameterauflistung zugeordnet. Parameter werden der aktuellen Zeile über die SourceColumn Eigenschaften und SourceVersion einer .NET Framework-Datenanbieterklasse Parameter zugeordnet. SourceColumn verweist auf eine DataTable Spalte, auf die verwiesen DbDataAdapter wird, um Parameterwerte für die aktuelle Zeile abzurufen.

SourceColumn verweist auf den namen der nicht zugeordneten Spalte, 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 Ausgeführte Aktion
MissingMappingAction.Passthrough Verwenden Sie die Quellspaltennamen und Tabellennamen in, DataSet wenn keine Zuordnung vorhanden ist.
MissingMappingAction.Ignore Ein 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 Ein 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 auf eine nicht vorhandene Spalte verweist.

Die SourceVersion -Eigenschaft einer .NET Framework-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 Verstöße gegen die optimistische Parallelität zu überprüfen.

Hinweis

Wenn beim Aktualisieren einer Zeile ein Fehler auftritt, wird eine Ausnahme ausgelöst, und die Ausführung des Updates wird eingestellt. Um den Aktualisierungsvorgang fortzusetzen, ohne Ausnahmen zu generieren, wenn ein Fehler auftritt, legen Sie die ContinueUpdateOnError -Eigenschaft auf fest true , bevor Sie aufrufen Update. Sie können auch auf Fehler pro Zeile innerhalb des RowUpdated DataAdapter-Ereignisses reagieren. Um den Aktualisierungsvorgang fortzusetzen, ohne eine Ausnahme innerhalb des RowUpdated Ereignisses zu generieren, legen Sie die Status -Eigenschaft von RowUpdatedEventArgs auf fest Continue.

Weitere Informationen

Gilt für:

Update(DataSet)

Quelle:
DbDataAdapter.cs
Quelle:
DbDataAdapter.cs
Quelle:
DbDataAdapter.cs

Aktualisiert die Werte in der Datenbank, indem für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen DataSet die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung ausgeführt werden.

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 DataSet, mit der die Datenquelle aktualisiert wird.

Gibt zurück

Die Anzahl der erfolgreich aktualisierten Zeilen im DataSet.

Implementiert

Ausnahmen

Die Quelltabelle ist ungültig.

Der Versuch, eine INSERT-Anweisung, UPDATE-Anweisung oder DELETE-Anweisung auszuführen, ergab 0 (null) betroffene Datensätze.

Beispiele

Im folgenden Beispiel wird die abgeleitete Klasse verwendet, OleDbDataAdapterum 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

Wenn eine Anwendung die Update -Methode aufruft, DbDataAdapter überprüft die RowState -Eigenschaft und führt die erforderlichen INSERT-, UPDATE- oder DELETE-Anweisungen iterativ für jede Zeile aus, basierend auf der Reihenfolge der in DataSetkonfigurierten Indizes. Beispielsweise Update kann aufgrund der Reihenfolge der Zeilen im eine DELETE-Anweisung gefolgt von einer INSERT-Anweisung und dann eine weitere DELETE-Anweisung ausgeführt werden 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. 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 - oder OleDbCommandBuilder -SqlCommandBuilderObjekt erstellen, um SQL-Anweisungen für Einzeltabellenupdates 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 ruft Zeilen aus der Tabelle ab, die in der ersten Zuordnung aufgeführt ist, bevor ein Update ausgeführt wird. Anschließend Update wird die Zeile mithilfe des Werts der UpdatedRowSource -Eigenschaft aktualisiert. Alle zusätzlichen zurückgegebenen Zeilen werden ignoriert.

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

Bei Verwendung Updateist die Ausführungsreihenfolge wie folgt:

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

  2. Das OnRowUpdating-Ereignis wird ausgelöst.

  3. Der Befehl wird ausgeführt.

  4. Wenn der Befehl auf FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.

  5. Wenn Ausgabeparameter vorhanden sind, werden sie im DataRowplatziert.

  6. Das OnRowUpdated-Ereignis wird ausgelöst.

  7. AcceptChanges wird aufgerufen.

Jedem Befehl, der dem DbDataAdapter zugeordnet ist, ist normalerweise eine Parameterauflistung zugeordnet. Parameter werden der aktuellen Zeile über die SourceColumn Eigenschaften und SourceVersion einer .NET Framework-Datenanbieterklasse Parameter zugeordnet. SourceColumn verweist auf eine DataTable Spalte, auf die die DbDataAdapter Parameterwerte für die aktuelle Zeile abgerufen werden soll.

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 Ausgeführte Aktion
MissingMappingAction.Passthrough Verwenden Sie die Quellspaltennamen und Tabellennamen in der DataSet , wenn keine Zuordnung vorhanden ist.
MissingMappingAction.Ignore Ein SystemException wird generiert. Wenn die Zuordnungen explizit festgelegt werden, ist eine fehlende Zuordnung für einen Eingabeparameter normalerweise das Ergebnis eines Fehlers.
MissingMappingAction.Error Ein 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 auf eine nicht vorhandene Spalte verweist.

Die SourceVersion -Eigenschaft einer .NET Framework-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 aufzunehmen, um nach Verstößen gegen optimistische Parallelität zu suchen.

Hinweis

Wenn beim Aktualisieren einer Zeile ein Fehler auftritt, wird eine Ausnahme ausgelöst, und die Ausführung des Updates wird eingestellt. Um den Aktualisierungsvorgang fortzusetzen, ohne Ausnahmen zu generieren, wenn ein Fehler auftritt, legen Sie die ContinueUpdateOnError -Eigenschaft auf true fest, bevor Sie aufrufen Update. Sie können auch auf Fehler pro Zeile innerhalb des RowUpdated DataAdapter-Ereignisses reagieren. Um den Aktualisierungsvorgang fortzusetzen, ohne eine Ausnahme innerhalb des RowUpdated Ereignisses zu generieren, legen Sie die Status -Eigenschaft von RowUpdatedEventArgs auf fest Continue.

Weitere Informationen

Gilt für:

Update(DataRow[])

Quelle:
DbDataAdapter.cs
Quelle:
DbDataAdapter.cs
Quelle:
DbDataAdapter.cs

Aktualisiert die Werte in der Datenbank, indem für jede eingefügte, aktualisierte oder gelöschte Zeile im angegebenen Array in DataSet die INSERT-Anweisung, die UPDATE-Anweisung bzw. die DELETE-Anweisung ausgeführt werden.

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, mit denen die Datenquelle aktualisiert wird.

Gibt zurück

Die Anzahl der erfolgreich aktualisierten Zeilen im DataSet.

Ausnahmen

Die Quelltabelle ist ungültig.

Es ist keine zu aktualisierende DataRow vorhanden.

- oder -

Es ist keine zu aktualisierende DataTable vorhanden.

- oder -

Es ist kein DataSet vorhanden, das als Quelle verwendet werden kann.

Der Versuch, eine INSERT-Anweisung, UPDATE-Anweisung oder DELETE-Anweisung auszuführen, ergab 0 (null) betroffene Datensätze.

Beispiele

Im folgenden Beispiel wird die abgeleitete Klasse verwendet, OleDbDataAdapterum 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

Wenn eine Anwendung die Update -Methode aufruft, untersucht die DbDataAdapter - RowState Eigenschaft und führt die erforderlichen INSERT-, UPDATE- oder DELETE-Anweisungen iterativ für jede Zeile aus, basierend auf der Reihenfolge der in DataSetkonfigurierten Indizes. Update Beispielsweise kann aufgrund der Reihenfolge der Zeilen in DataTableder eine DELETE-Anweisung gefolgt von einer INSERT-Anweisung und dann eine weitere DELETE-Anweisung ausgeführt werden.

Beachten Sie, 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.

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 Einzeltabellenupdates 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 ruft Zeilen aus der Tabelle ab, die in der ersten Zuordnung aufgeführt ist, bevor ein Update ausgeführt wird. Anschließend Update wird die Zeile mithilfe des Werts der UpdatedRowSource -Eigenschaft aktualisiert. Alle zusätzlichen zurückgegebenen Zeilen werden ignoriert.

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

Bei Verwendung Updateist die Ausführungsreihenfolge wie folgt:

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

  2. Das OnRowUpdating-Ereignis wird ausgelöst.

  3. Der Befehl wird ausgeführt.

  4. Wenn der Befehl auf FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.

  5. Wenn Ausgabeparameter vorhanden sind, werden sie im DataRowplatziert.

  6. Das OnRowUpdated-Ereignis wird ausgelöst.

  7. AcceptChanges wird aufgerufen.

Jedem Befehl, der dem DbDataAdapter zugeordnet ist, ist normalerweise eine Parameterauflistung zugeordnet. Parameter werden der aktuellen Zeile über die SourceColumn Eigenschaften und SourceVersion einer .NET Framework-Datenanbieterklasse Parameter zugeordnet. SourceColumn verweist auf eine DataTable Spalte, auf die die DbDataAdapter Parameterwerte für die aktuelle Zeile abgerufen werden soll.

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 Ausgeführte Aktion
MissingMappingAction.Passthrough Verwenden Sie die Quellspaltennamen und Tabellennamen in der DataSet , wenn keine Zuordnung vorhanden ist.
MissingMappingAction.Ignore Ein SystemException wird generiert. Wenn die Zuordnungen explizit festgelegt werden, ist eine fehlende Zuordnung für einen Eingabeparameter normalerweise das Ergebnis eines Fehlers.
MissingMappingAction.Error Ein 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 auf eine nicht vorhandene Spalte verweist.

Die SourceVersion -Eigenschaft einer .NET Framework-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 aufzunehmen, um nach Verstößen gegen optimistische Parallelität zu suchen.

Hinweis

Wenn beim Aktualisieren einer Zeile ein Fehler auftritt, wird eine Ausnahme ausgelöst, und die Ausführung des Updates wird eingestellt. Um den Aktualisierungsvorgang fortzusetzen, ohne Ausnahmen zu generieren, wenn ein Fehler auftritt, legen Sie die ContinueUpdateOnError -Eigenschaft auf true fest, bevor Sie aufrufen Update. Sie können auch auf Fehler pro Zeile innerhalb des RowUpdated DataAdapter-Ereignisses reagieren. Um den Aktualisierungsvorgang fortzusetzen, ohne eine Ausnahme innerhalb des RowUpdated Ereignisses zu generieren, legen Sie die Status -Eigenschaft von RowUpdatedEventArgs auf fest Continue.

Weitere Informationen

Gilt für: