DbDataAdapter.Update 方法

參考

定義

命名空間:: System.Data.Common

組件:: System.Data.Common.dll

組件:: System.Data.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

針對 DataSet 中的每個插入、更新或刪除的資料列，執行個別的 INSERT、UPDATE 或 DELETE 陳述式，以更新資料庫中的值。

多載

Update(DataSet, String)	針對具有指定 DataTable 名稱之 DataSet 中的每個插入、更新或刪除的資料列，執行個別的 INSERT、UPDATE 或 DELETE 陳述式，以更新資料庫中的值。
Update(DataRow[], DataTableMapping)	針對 DataRow 物件的指定陣列中每個插入、更新或刪除的資料列，執行個別的 INSERT、UPDATE 或 DELETE 陳述式，以更新資料庫中的值。
Update(DataTable)	針對指定之 DataTable 中的每個插入、更新或刪除的資料列，執行個別的 INSERT、UPDATE 或 DELETE 陳述式，以更新資料庫中的值。
Update(DataSet)	針對指定之 DataSet 中的每個插入、更新或刪除的資料列，執行個別的 INSERT、UPDATE 或 DELETE 陳述式，以更新資料庫中的值。
Update(DataRow[])	針對 DataSet 的指定陣列中每個插入、更新或刪除的資料列，執行個別的 INSERT、UPDATE 或 DELETE 陳述式，以更新資料庫中的值。

Update(DataSet, String)

來源:: DbDataAdapter.cs

來源:: DbDataAdapter.cs

來源:: DbDataAdapter.cs

針對具有指定 DataTable 名稱之 DataSet 中的每個插入、更新或刪除的資料列，執行個別的 INSERT、UPDATE 或 DELETE 陳述式，以更新資料庫中的值。

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

參數

dataSet: DataSet

用來更新資料來源的 DataSet。

srcTable: String

用於資料表對應的來源資料表名稱。

傳回

Int32

自 DataSet 中成功更新的資料列數目。

例外狀況

ArgumentNullException

DataSet 無效。

InvalidOperationException

來源資料表無效。

DBConcurrencyException

嘗試執行 INSERT、UPDATE 或 DELETE 陳述式會造成沒有資料錄受影響。

範例

下列範例會使用衍生類別 OleDbDataAdapter，來更新數據源。

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

備註

當應用程式呼叫 Update 方法時，會 DbDataAdapter 檢查 RowState 屬性，並根據中所 DataSet設定的索引順序，反覆執行每個數據列的必要 INSERT、UPDATE 或 DELETE 語句。例如， Update 可能會執行 DELETE 語句，後面接著 INSERT 語句，然後執行另一個 DELETE 語句，因為中 DataTable數據列的順序。

請注意，這些語句不會以批處理方式執行;每個數據列都會個別更新。應用程式可以在您必須控制語句類型序列的情況下呼叫 GetChanges 方法，例如，UPDATE) 之前，先 (INSERT。如需詳細資訊，請參閱使用 DataAdapters 更新資料來源。

如果未指定 INSERT、UPDATE 或 DELETE 語句，此方法 Update 會產生例外狀況。不過，如果您設定 SelectCommand .NET Framework 數據提供者的屬性，您可以建立 SqlCommandBuilder 或 OleDbCommandBuilder 對象來自動產生單一數據表更新的 SQL 語句。然後，您未設定的任何其他 SQL 語句都會由 CommandBuilder 產生。此產生邏輯需要中 DataSet存在索引鍵數據行資訊。如需詳細資訊，請參閱使用 CommandBuilders 產生命令。

方法 Update 支援的案例，其中 DataSet 包含多個 DataTable 對象的名稱只依大小寫而有所不同。當多個具有相同名稱但不同大小寫的數據表存在於中DataSetUpdate時，會執行區分大小寫的比較來尋找對應的數據表，並在沒有完全相符專案時產生例外狀況。下列 C# 程式代碼說明此行為。

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.

如果 Update 呼叫，且 DataSet 只 DataTable 包含名稱只依大小寫 DataTable 而不同之名稱的，則會更新。在此案例中，比較不區分大小寫。下列 C# 程式代碼說明此行為。

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.

方法會 Update 先從第一個對應中列出的數據表擷取數據列，再執行更新。 Update然後使用屬性的值UpdatedRowSource重新整理數據列。會忽略傳回的任何其他數據列。

載入回 DataSet的任何數據之後， OnRowUpdated 就會引發事件，讓使用者能夠檢查已協調 DataSet 的數據列和命令傳回的任何輸出參數。成功更新數據列之後，就會接受該數據列的變更。

使用 Update時，執行順序如下：

中的 DataRow 值會移至參數值。
便會引發 OnRowUpdating 事件。
命令會執行。
如果命令設定 FirstReturnedRecord為，則第一個傳回的結果會放在中 DataRow。
如果有輸出參數，它們會放在中 DataRow。
便會引發 OnRowUpdated 事件。
呼叫 AcceptChanges。

與相關聯的 DbDataAdapter 每個命令通常都有與其相關聯的參數集合。參數會透過 SourceColumn .NET Framework 數據提供者類別Parameter的和 SourceVersion 屬性，對應至目前的數據列。 SourceColumn會DataTable DbDataAdapter參考以取得目前數據列之參數值的數據行。

SourceColumn 在套用任何數據表對應之前，會參考未對應的數據行名稱。如果 SourceColumn 參考不存在的數據行，所採取的動作取決於下列 MissingMappingAction 其中一個值。

列舉值	已採取的動作
`MissingMappingAction.Passthrough`	如果沒有對應，請使用中的 DataSet 源數據行名稱和數據表名稱。
`MissingMappingAction.Ignore`	會產生。SystemException 明確設定對應時，輸入參數遺漏的對應通常是錯誤的結果。
`MissingMappingAction.Error`	會產生。SystemException

屬性 SourceColumn 也可用來將輸出或輸入/輸出參數的值對應回 DataSet。如果例外狀況參考不存在的數據行，就會產生例外狀況。

SourceVersion.NET Framework 數據提供者類別Parameter的屬性會決定要使用數據行值的原始、目前或建議版本。這項功能通常用於在 UPDATE 語句的 WHERE 子句中包含原始值，以檢查開放式並行存取違規。

注意

如果在更新數據列時發生錯誤，則會擲回例外狀況，並停止更新的執行。若要在遇到錯誤時繼續更新作業而不產生例外狀況，請在呼叫之前將 ContinueUpdateOnError 屬性設定為 true 。Update 您也可以在 DataAdapter 事件內 RowUpdated ，根據每個數據列回應錯誤。若要繼續更新作業，而不在事件內 RowUpdated 產生例外狀況，請將 Status 的 RowUpdatedEventArgs 屬性設定為 Continue。

另請參閱

適用於

Update(DataRow[], DataTableMapping)

來源:: DbDataAdapter.cs

來源:: DbDataAdapter.cs

來源:: DbDataAdapter.cs

針對 DataRow 物件的指定陣列中每個插入、更新或刪除的資料列，執行個別的 INSERT、UPDATE 或 DELETE 陳述式，以更新資料庫中的值。

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

參數

dataRows: DataRow[]

用來更新資料來源的 DataRow 物件陣列。

tableMapping: DataTableMapping

要使用的 TableMappings 集合。

傳回

Int32

從物件的陣列成功更新的數據列 DataRow 數目。

例外狀況

ArgumentNullException

DataSet 無效。

InvalidOperationException

來源資料表無效。

SystemException

要更新的 DataRow 不存在。

-或-

要更新的 DataTable 不存在。

-或-

要用來做為來源的 DataSet 不存在。

DBConcurrencyException

嘗試執行 INSERT、UPDATE 或 DELETE 陳述式會造成沒有資料錄受影響。

備註

請注意，這些語句不會以批處理方式執行;每個數據列都會個別更新。應用程式可以在您必須控制語句類型的序列的情況下呼叫 GetChanges 方法，例如，在UPDATEEs) 之前，INSERT (。如需詳細資訊，請參閱使用 DataAdapters 更新資料來源。

使用 Update時，執行順序如下：

中的 DataRow 值會移至參數值。
便會引發 OnRowUpdating 事件。
命令會執行。
如果命令設定為 FirstReturnedRecord，則會將 DataRow第一個傳回的結果放在中。
如果有輸出參數，它們會放在中 DataRow。
便會引發 OnRowUpdated 事件。
呼叫 AcceptChanges。

與相關聯的 DbDataAdapter 每個命令通常會有與其相關聯的參數集合。參數會透過 SourceColumn .NET Framework 數據提供者類別Parameter的和 SourceVersion 屬性，對應至目前的數據列。 SourceColumnDataTable DbDataAdapter是指參考以取得目前數據列之參數值的數據行。

SourceColumn 是指套用任何數據表對應之前未對應的數據行名稱。如果 SourceColumn 參考不存在的數據行，所採取的動作取決於下列 MissingMappingAction 其中一個值。

列舉值	已採取的動作
`MissingMappingAction.Passthrough`	如果沒有對應，請使用中的 DataSet 源數據行名稱和數據表名稱。
`MissingMappingAction.Ignore`	產生。SystemException 明確設定對應時，輸入參數遺漏的對應通常是錯誤的結果。
`MissingMappingAction.Error`	產生。SystemException

屬性 SourceColumn 也可用來將輸出或輸入/輸出參數的值對應回 DataSet。如果例外狀況參考不存在的數據行，就會產生例外狀況。

SourceVersion.NET Framework 資料提供者類別的 Parameter 屬性會決定要使用數據行值的原始、目前或建議版本。這項功能通常用來在 UPDATE 語句的 WHERE 子句中包含原始值，以檢查開放式並行存取違規。

注意

如果在更新數據列時發生錯誤，則會擲回例外狀況，並停止執行更新。若要在發生錯誤時繼續更新作業而不產生例外狀況，請在呼叫之前將 ContinueUpdateOnError 屬性設定為 true 。Update 您也可以在 DataAdapter 事件內 RowUpdated ，依數據列回應錯誤。若要繼續更新作業而不在事件內 RowUpdated 產生例外狀況，請將 Status 的 RowUpdatedEventArgs 屬性設定為 Continue。

另請參閱

適用於

Update(DataTable)

來源:: DbDataAdapter.cs

來源:: DbDataAdapter.cs

來源:: DbDataAdapter.cs

針對指定之 DataTable 中的每個插入、更新或刪除的資料列，執行個別的 INSERT、UPDATE 或 DELETE 陳述式，以更新資料庫中的值。

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

參數

dataTable: DataTable

用來更新資料來源的 DataTable。

傳回

Int32

自 DataTable 中成功更新的資料列數目。

例外狀況

ArgumentNullException

DataSet 無效。

InvalidOperationException

來源資料表無效。

SystemException

要更新的 DataRow 不存在。

-或-

要更新的 DataTable 不存在。

-或-

要用來做為來源的 DataSet 不存在。

DBConcurrencyException

嘗試執行 INSERT、UPDATE 或 DELETE 陳述式會造成沒有資料錄受影響。

範例

下列範例使用衍生類別 OleDbDataAdapter來更新數據源。

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

備註

當應用程式呼叫方法時 Update ，會 DbDataAdapter 檢查 RowState 屬性，並根據中所 DataSet設定的索引順序，反覆執行每個數據列所需的 INSERT、UPDATE 或 DELETE 語句。例如， Update 可能會執行 DELETE 語句，後面接著 INSERT 語句，然後執行另一個 DELETE 語句，因為中數據列 DataTable的順序。

請注意，這些語句不會以批處理方式執行;每個數據列會個別更新。應用程式可以在您必須控制語句類型的序列 (的情況下呼叫 GetChanges 方法，例如，UPDATEEs) 之前的 INSERT。如需詳細資訊，請參閱使用 DataAdapters 更新資料來源。

如果未指定 INSERT、UPDATE 或 DELETE 語句，方法 Update 會產生例外狀況。不過，如果您設定 SelectCommand .NET Framework 數據提供者的屬性，您可以建立 SqlCommandBuilder 或 OleDbCommandBuilder 對象來自動產生單一數據表更新的 SQL 語句。然後，您未設定的任何其他 SQL 語句都會由 CommandBuilder 產生。此產生邏輯需要在中 DataSet提供索引鍵數據行資訊。如需詳細資訊，請參閱使用 CommandBuilders 產生命令。

方法 Update 會先從第一個對應中列出的數據表擷取數據列，然後再執行更新。 Update然後使用屬性的值UpdatedRowSource重新整理數據列。會忽略傳回的任何其他數據列。

將任何數據載入回 DataSet之後， OnRowUpdated 就會引發事件，讓使用者檢查協調 DataSet 的數據列和命令傳回的任何輸出參數。成功更新數據列之後，就會接受該數據列的變更。

使用 Update時，執行順序如下所示：

中的 DataRow 值會移至參數值。
便會引發 OnRowUpdating 事件。
命令會執行。
如果命令設定為 FirstReturnedRecord，則會將 DataRow第一個傳回的結果放在中。
如果有輸出參數，它們會放在中 DataRow。
便會引發 OnRowUpdated 事件。
呼叫 AcceptChanges。

列舉值	已採取的動作
`MissingMappingAction.Passthrough`	如果沒有對應，請使用中的 DataSet 源數據行名稱和數據表名稱。
`MissingMappingAction.Ignore`	產生。SystemException 明確設定對應時，輸入參數遺漏的對應通常是錯誤的結果。
`MissingMappingAction.Error`	產生。SystemException

屬性 SourceColumn 也可用來將輸出或輸入/輸出參數的值對應回 DataSet。如果例外狀況參考不存在的數據行，就會產生例外狀況。

注意

另請參閱

適用於

Update(DataSet)

來源:: DbDataAdapter.cs

來源:: DbDataAdapter.cs

來源:: DbDataAdapter.cs

針對指定之 DataSet 中的每個插入、更新或刪除的資料列，執行個別的 INSERT、UPDATE 或 DELETE 陳述式，以更新資料庫中的值。

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

參數

dataSet: DataSet

用來更新資料來源的 DataSet。

傳回

Int32

自 DataSet 中成功更新的資料列數目。

實作

Update(DataSet)

例外狀況

InvalidOperationException

來源資料表無效。

DBConcurrencyException

嘗試執行 INSERT、UPDATE 或 DELETE 陳述式會造成沒有資料錄受影響。

範例

下列範例使用衍生類別 OleDbDataAdapter來更新數據源。

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

備註

使用 Update時，執行順序如下所示：

中的 DataRow 值會移至參數值。
便會引發 OnRowUpdating 事件。
命令會執行。
如果命令設定為 FirstReturnedRecord，則會將 DataRow第一個傳回的結果放在中。
如果有輸出參數，它們會放在中 DataRow。
便會引發 OnRowUpdated 事件。
呼叫 AcceptChanges。

列舉值	已採取的動作
`MissingMappingAction.Passthrough`	如果沒有對應，請使用中的 DataSet 源數據行名稱和數據表名稱。
`MissingMappingAction.Ignore`	產生。SystemException 明確設定對應時，輸入參數遺漏的對應通常是錯誤的結果。
`MissingMappingAction.Error`	產生。SystemException

屬性 SourceColumn 也可用來將輸出或輸入/輸出參數的值對應回 DataSet。如果例外狀況參考不存在的數據行，就會產生例外狀況。

注意

另請參閱

適用於

Update(DataRow[])

來源:: DbDataAdapter.cs

來源:: DbDataAdapter.cs

來源:: DbDataAdapter.cs

針對 DataSet 的指定陣列中每個插入、更新或刪除的資料列，執行個別的 INSERT、UPDATE 或 DELETE 陳述式，以更新資料庫中的值。

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

參數

dataRows: DataRow[]

用來更新資料來源的 DataRow 物件陣列。

傳回

Int32

自 DataSet 中成功更新的資料列數目。

例外狀況

ArgumentNullException

DataSet 無效。

InvalidOperationException

來源資料表無效。

SystemException

要更新的 DataRow 不存在。

-或-

要更新的 DataTable 不存在。

-或-

要用來做為來源的 DataSet 不存在。

DBConcurrencyException

嘗試執行 INSERT、UPDATE 或 DELETE 陳述式會造成沒有資料錄受影響。

範例

下列範例使用衍生類別 OleDbDataAdapter來更新數據源。

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

備註

使用 Update時，執行順序如下所示：

中的 DataRow 值會移至參數值。
便會引發 OnRowUpdating 事件。
命令會執行。
如果命令設定為 FirstReturnedRecord，則會將 DataRow第一個傳回的結果放在中。
如果有輸出參數，它們會放在中 DataRow。
便會引發 OnRowUpdated 事件。
呼叫 AcceptChanges。

列舉值	已採取的動作
`MissingMappingAction.Passthrough`	如果沒有對應，請使用中的 DataSet 源數據行名稱和數據表名稱。
`MissingMappingAction.Ignore`	產生。SystemException 明確設定對應時，輸入參數遺漏的對應通常是錯誤的結果。
`MissingMappingAction.Error`	產生。SystemException

屬性 SourceColumn 也可用來將輸出或輸入/輸出參數的值對應回 DataSet。如果例外狀況參考不存在的數據行，就會產生例外狀況。

注意

另請參閱

適用於

共用方式為

DbDataAdapter.Update 方法

定義

多載

Update(DataSet, String)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

Update(DataRow[], DataTableMapping)

參數

傳回

例外狀況

備註

另請參閱

適用於

Update(DataTable)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

Update(DataSet)

參數

傳回

實作

例外狀況

範例

備註

另請參閱

適用於

Update(DataRow[])

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

其他資源