DataAdapter.Update(DataSet) 方法

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

Source:

DataAdapter.cs

从名为“Table”的 DataSet 为指定的 DataTable 中每个已插入、已更新或已删除的行调用相应的 INSERT、UPDATE 或 DELETE 语句。

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

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

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

Public Overridable Function Update (dataSet As DataSet) As Integer

参数

dataSet

DataSet

用于更新数据源的 DataSet。

返回

Int32

DataSet 中成功更新的行数。

实现

Update(DataSet)

例外

InvalidOperationException

源表无效。

DBConcurrencyException

尝试执行 INSERT、UPDATE 或 DELETE 语句，但没有记录受到影响。

示例

以下示例对数据源使用派生类 OleDbDataAdapter。Update

static private DataSet CreateCommandAndUpdate(
    string connectionString,
    string queryString)
{
    DataSet dataSet = new DataSet();

    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbDataAdapter adapter =
            new OleDbDataAdapter();
        adapter.SelectCommand =
            new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder =
            new OleDbCommandBuilder(adapter);

        adapter.Fill(dataSet);

        // Code to modify data in the DataSet here.

        // Without the OleDbCommandBuilder, this line would fail.
        adapter.UpdateCommand = builder.GetUpdateCommand();
        adapter.Update(dataSet);
    }
    return dataSet;
}

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

    Dim dataSet As New DataSet()

    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim adapter As New OleDbDataAdapter()

        adapter.SelectCommand = New OleDbCommand( _
            queryString, connection)

        Dim builder As OleDbCommandBuilder = _
            New OleDbCommandBuilder(adapter)

        adapter.Fill(dataSet)

        ' Code to modify the data in the DataSet here. 

        ' Without the OleDbCommandBuilder this line would fail.
        builder.GetUpdateCommand()
        adapter.Update(dataSet)
    End Using
    Return dataSet
End Function

注解

更新按行执行。 对于每个插入、修改和删除的行， Update 方法确定 (插入、更新或删除) 对其进行的更改类型。 根据更改的类型， Insert执行 、 Update, 或 Delete 命令模板将修改的行传播到数据源。 当应用程序调用 Update 方法时，会 DataAdapter 检查 RowState 属性，并根据 中 DataSet配置的索引顺序，对每一行迭代执行所需的 INSERT、UPDATE 或 DELETE 语句。 例如， Update 可能会执行 DELETE 语句，后跟 INSERT 语句，然后执行另一个 DELETE 语句，因为 中 DataTable行的顺序。

应注意的是，这些语句不是作为批处理执行的;每一行都单独更新。 在必须控制语句类型序列的情况下，应用程序可以调用 GetChanges 方法， (例如，在 UPDATE) 之前插入。 有关详细信息，请参阅使用 DataAdapters 更新数据源。

如果未指定 INSERT、UPDATE 或 DELETE 语句，该方法 Update 将生成异常。 但是，如果设置 SelectCommand .NET Framework 数据提供程序的 属性，则可以创建 SqlCommandBuilder 或 OleDbCommandBuilder 对象来自动生成单表更新的 SQL 语句。 然后，任何其他未设置的 SQL 语句都会由 CommandBuilder 生成。 此生成逻辑要求键列信息存在于 中 DataSet。 有关详细信息，请参阅 使用 CommandBuilders 生成命令。

在执行更新之前， Update 方法从第一个映射中列出的表中检索行。 Update然后使用 属性的值UpdatedRowSource刷新行。 将忽略返回的任何其他行。

将任何数据加载回 后 DataSet， OnRowUpdated 将引发 事件，允许用户检查协调 DataSet 行以及命令返回的任何输出参数。 成功更新行后，将接受对该行的更改。

使用 Update时，执行顺序如下：

1. 中的 DataRow 值将移动到参数值。

2. 引发 OnRowUpdating 事件。

3. 命令执行。

4. 如果命令设置为 FirstReturnedRecord，则返回的第一个结果将放在 中 DataRow。

5. 如果有输出参数，则它们放置在 中 DataRow。

6. 引发 OnRowUpdated 事件。

7. 调用 DataRow.AcceptChanges。 这将为更新DataRow的 引发 DataTable.RowChanging 和 DataTable.RowChanged 事件。

与 关联的 DataAdapter 每个命令通常都有一个与之关联的参数集合。 参数通过 SourceColumn .NET 数据提供程序Parameter类的 和 SourceVersion 属性映射到当前行。 SourceColumn 引用引用 DataTable 的列 DataAdapter 以获取当前行的参数值。

SourceColumn 是指应用任何表映射之前未映射的列名。 如果 SourceColumn 引用不存在的列，则执行的操作取决于以下 MissingMappingAction 值之一。

枚举值	采取的操作
MissingMappingAction.Passthrough	如果没有映射，请使用 中的 DataSet 源列名称和表名。
MissingMappingAction.Ignore	SystemException将生成 。 显式设置映射时，输入参数缺少映射通常是错误的结果。
MissingMappingAction.Error	SystemException将生成 。

属性SourceColumn还用于将输出或输入/输出参数的值映射回 。DataSet 如果引用不存在的列，则会生成异常。

SourceVersion.NET 数据提供程序类的 Parameter 属性确定是使用列值的原始版本、当前版本还是建议版本。 此功能通常用于在 UPDATE 语句的 WHERE 子句中包含原始值，以检查乐观并发冲突。

AcceptChanges调用 方法或 AcceptChanges 方法将提交 或 DataTable中的所有DataSet更改。 如果在调用方法之前Update调用了其中任一方法，则调用该方法时Update不会提交任何更改，除非自 或 AcceptChanges 调用后AcceptChanges进行了进一步的更改。

备注

如果在更新行时出错，则会引发异常并停止执行更新。 若要在遇到错误时继续执行更新操作而不生成异常，请在调用 之前将 ContinueUpdateOnError 属性设置为 true 。Update 还可以在 DataAdapter 事件中 RowUpdated 按行响应错误。 若要继续更新操作而不在 RowUpdated 事件中生成异常，请将 的 RowUpdatedEventArgs 属性设置为 StatusContinue。

对于传播到 上的 Update数据源的每个列，都应将参数添加到 InsertCommand、 UpdateCommand或 DeleteCommand。 参数 SourceColumn 的 属性应设置为列的名称。 此设置指示参数的值不是手动设置的，而是从当前处理的行中的特定列获取的。

另请参阅

• ADO.NET 概述