DbDataAdapter.Update 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 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)
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 -> intPublic Function Update (dataSet As DataSet, srcTable As String) As Integer參數
- srcTable
- String
用於資料表對應的來源資料表名稱。
傳回
自 DataSet 中成功更新的資料列數目。
例外狀況
來源資料表無效。
嘗試執行 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會DataTableDbDataAdapter參考以取得目前數據列之參數值的數據行。
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。
另請參閱
- 操作資料 (ADO.NET)
- DbProviderFactory (ADO.NET)
- ADO.NET 概觀 \(部分機器翻譯\)
適用於
Update(DataRow[], DataTableMapping)
針對 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 -> intProtected Overridable Function Update (dataRows As DataRow(), tableMapping As DataTableMapping) As Integer參數
- tableMapping
- DataTableMapping
要使用的 TableMappings 集合。
傳回
從物件的陣列成功更新的數據列 DataRow 數目。
例外狀況
來源資料表無效。
嘗試執行 INSERT、UPDATE 或 DELETE 陳述式會造成沒有資料錄受影響。
備註
當應用程式呼叫 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。
與相關聯的 DbDataAdapter 每個命令通常會有與其相關聯的參數集合。 參數會透過 SourceColumn .NET Framework 數據提供者類別Parameter的 和 SourceVersion 屬性，對應至目前的數據列。 SourceColumnDataTableDbDataAdapter是指參考以取得目前數據列之參數值的數據行。
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。
另請參閱
- 操作資料 (ADO.NET)
- DbProviderFactory (ADO.NET)
- ADO.NET 概觀 \(部分機器翻譯\)
適用於
Update(DataTable)
針對指定之 DataTable 中的每個插入、更新或刪除的資料列，執行個別的 INSERT、UPDATE 或 DELETE 陳述式，以更新資料庫中的值。
public:
int Update(System::Data::DataTable ^ dataTable);public int Update (System.Data.DataTable dataTable);override this.Update : System.Data.DataTable -> intPublic Function Update (dataTable As DataTable) As Integer參數
傳回
自 DataTable 中成功更新的資料列數目。
例外狀況
來源資料表無效。
嘗試執行 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。
與相關聯的 DbDataAdapter 每個命令通常會有與其相關聯的參數集合。 參數會透過 SourceColumn .NET Framework 數據提供者類別Parameter的 和 SourceVersion 屬性，對應至目前的數據列。 SourceColumnDataTableDbDataAdapter是指參考以取得目前數據列之參數值的數據行。
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。
另請參閱
- 操作資料 (ADO.NET)
- DbProviderFactory (ADO.NET)
- ADO.NET 概觀 \(部分機器翻譯\)
適用於
Update(DataSet)
針對指定之 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 -> intPublic Overrides Function Update (dataSet As DataSet) As Integer參數
傳回
自 DataSet 中成功更新的資料列數目。
實作
例外狀況
來源資料表無效。
嘗試執行 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 ，會 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。
與相關聯的 DbDataAdapter 每個命令通常會有與其相關聯的參數集合。 參數會透過 SourceColumn .NET Framework 數據提供者類別Parameter的 和 SourceVersion 屬性，對應至目前的數據列。 SourceColumnDataTableDbDataAdapter是指參考以取得目前數據列之參數值的數據行。
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。
另請參閱
- 操作資料 (ADO.NET)
- DbProviderFactory (ADO.NET)
- ADO.NET 概觀 \(部分機器翻譯\)
適用於
Update(DataRow[])
針對 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[] -> intPublic Function Update (dataRows As DataRow()) As Integer參數
傳回
自 DataSet 中成功更新的資料列數目。
例外狀況
來源資料表無效。
嘗試執行 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 ，會 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。
與相關聯的 DbDataAdapter 每個命令通常會有與其相關聯的參數集合。 參數會透過 SourceColumn .NET Framework 數據提供者類別Parameter的 和 SourceVersion 屬性，對應至目前的數據列。 SourceColumnDataTableDbDataAdapter是指參考以取得目前數據列之參數值的數據行。
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。
另請參閱
- 操作資料 (ADO.NET)
- DbProviderFactory (ADO.NET)
- ADO.NET 概觀 \(部分機器翻譯\)
適用於
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應