DbDataAdapter.Update Methode

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

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

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

1. Die Werte im 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 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.

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.

Weitere Informationen

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

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

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

1. Die Werte im 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 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.

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.

Weitere Informationen

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

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

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

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

1. Die Werte im 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 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.

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.

Weitere Informationen

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

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

Gibt zurück

Die Anzahl der Zeilen wurde erfolgreich aus dem DataSetaktualisiert.

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

1. Die Werte im 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 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.

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.

Weitere Informationen

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

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

Gibt zurück

Die Anzahl der Zeilen wurde erfolgreich aus dem DataSetaktualisiert.

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

1. Die Werte im 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 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.

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.

Weitere Informationen

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