DbDataAdapter.Update Methode

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

Gibt zurück

Die Anzahl der Zeilen wurde erfolgreich aus dem DataSet.

Ausnahmen

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 aufruftDbDataAdapter, ü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 der DataSetDatei konfigurierten 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 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 unterstützt Szenarien, in denen mehrere DataSet Objekte enthalten DataTable sind, 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.

Wird Update aufgerufen und enthält DataSet nur eine DataTable , deren Name nur nach Groß-/Kleinschreibung unterschiedlich ist, wird dies 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 eine Aktualisierung ausgeführt wird. Die Update aktualisiert 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 FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.

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

6. Das OnRowUpdated-Ereignis wird ausgelöst.

7. 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 Eigenschaften und SourceVersion Eigenschaften einer .NET Framework-Datenanbieterklasse Parameter zugeordnet. SourceColumn bezieht sich auf eine DataTable Spalte, auf die die Verweise zum Abrufen von DbDataAdapter 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.

Enumerationswert	Unternommene Aktion
MissingMappingAction.Passthrough	Verwenden Sie die Quellspaltennamen und Tabellennamen, DataSet wenn keine Zuordnung vorhanden ist.
MissingMappingAction.Ignore	A 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	A SystemException wird generiert.

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 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.

Weitere Informationen

• Bearbeiten von Daten (ADO.NET)
• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET

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

Gibt zurück

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

Ausnahmen

Hinweise

Wenn eine Anwendung die Update Methode aufruftDbDataAdapter, ü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 der DataSetDatei konfigurierten 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. 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. Die Update aktualisiert 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 FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.

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

6. Das OnRowUpdated-Ereignis wird ausgelöst.

7. 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 Eigenschaften und SourceVersion Eigenschaften einer .NET Framework-Datenanbieterklasse Parameter zugeordnet. SourceColumn bezieht sich auf eine DataTable Spalte, auf die die Verweise zum Abrufen von DbDataAdapter 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.

Enumerationswert	Unternommene Aktion
MissingMappingAction.Passthrough	Verwenden Sie die Quellspaltennamen und Tabellennamen, DataSet wenn keine Zuordnung vorhanden ist.
MissingMappingAction.Ignore	A 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	A SystemException wird generiert.

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 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.

Weitere Informationen

• Bearbeiten von Daten (ADO.NET)
• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET

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

Gibt zurück

Die Anzahl der Zeilen wurde erfolgreich aus dem DataTable.

Ausnahmen

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

Wenn eine Anwendung die Update Methode aufruftDbDataAdapter, ü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 der DataSetDatei konfigurierten 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. 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. Die Update aktualisiert 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 FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.

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

6. Das OnRowUpdated-Ereignis wird ausgelöst.

7. 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 Eigenschaften und SourceVersion Eigenschaften einer .NET Framework-Datenanbieterklasse Parameter zugeordnet. SourceColumn bezieht sich auf eine DataTable Spalte, auf die die Verweise zum Abrufen von DbDataAdapter 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.

Enumerationswert	Unternommene Aktion
MissingMappingAction.Passthrough	Verwenden Sie die Quellspaltennamen und Tabellennamen, DataSet wenn keine Zuordnung vorhanden ist.
MissingMappingAction.Ignore	A 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	A SystemException wird generiert.

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 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.

Weitere Informationen

• Bearbeiten von Daten (ADO.NET)
• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET

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

Gibt zurück

Die Anzahl der Zeilen wurde erfolgreich aus dem DataSet.

Implementiert

Ausnahmen

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

Wenn eine Anwendung die Update Methode aufruftDbDataAdapter, ü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 der DataSetDatei konfigurierten 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. 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. Die Update aktualisiert 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 FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.

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

6. Das OnRowUpdated-Ereignis wird ausgelöst.

7. 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 Eigenschaften und SourceVersion Eigenschaften einer .NET Framework-Datenanbieterklasse Parameter zugeordnet. SourceColumn bezieht sich auf eine DataTable Spalte, auf die die Verweise zum Abrufen von DbDataAdapter 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.

Enumerationswert	Unternommene Aktion
MissingMappingAction.Passthrough	Verwenden Sie die Quellspaltennamen und Tabellennamen, DataSet wenn keine Zuordnung vorhanden ist.
MissingMappingAction.Ignore	A 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	A SystemException wird generiert.

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 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.

Weitere Informationen

• Bearbeiten von Daten (ADO.NET)
• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET

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

Gibt zurück

Die Anzahl der Zeilen wurde erfolgreich aus dem DataSet.

Ausnahmen

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

Wenn eine Anwendung die Update Methode aufruftDbDataAdapter, ü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 der DataSetDatei konfigurierten 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. 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. Die Update aktualisiert 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 FirstReturnedRecordfestgelegt ist, wird das erste zurückgegebene Ergebnis in der DataRowplatziert.

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

6. Das OnRowUpdated-Ereignis wird ausgelöst.

7. 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 Eigenschaften und SourceVersion Eigenschaften einer .NET Framework-Datenanbieterklasse Parameter zugeordnet. SourceColumn bezieht sich auf eine DataTable Spalte, auf die die Verweise zum Abrufen von DbDataAdapter 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.

Enumerationswert	Unternommene Aktion
MissingMappingAction.Passthrough	Verwenden Sie die Quellspaltennamen und Tabellennamen, DataSet wenn keine Zuordnung vorhanden ist.
MissingMappingAction.Ignore	A 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	A SystemException wird generiert.

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 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.

Weitere Informationen

• Bearbeiten von Daten (ADO.NET)
• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET