DataAdapter.AcceptChangesDuringUpdate 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定在 AcceptChanges() 期間是否呼叫 Update(DataSet)。
public:
property bool AcceptChangesDuringUpdate { bool get(); void set(bool value); };public bool AcceptChangesDuringUpdate { get; set; }member this.AcceptChangesDuringUpdate : bool with get, setPublic Property AcceptChangesDuringUpdate As Boolean屬性值
如果在 AcceptChanges() 期間呼叫 Update(DataSet)，則為 true，否則為 false。 預設為 true。
範例
這則範例會示範如何從 DataTable 中擷取已變更的資料列，以及使用 SqlDataAdapter 來更新資料來源並擷取新的識別資料行值。 藉由將 AcceptChangesDuringUpdate 的 SqlDataAdapter 屬性設定為 false 以保留原始的自動遞增值，新數據就可以合併到原始 DataTable，即使新的識別值不符合 中 DataTable原始的自動遞增值也一樣。
private static void MergeIdentityColumns(string connectionString)
{
using (SqlConnection connection =
new SqlConnection(connectionString))
{
// Create the DataAdapter
SqlDataAdapter adapter =
new SqlDataAdapter(
"SELECT ShipperID, CompanyName FROM dbo.Shippers",
connection);
//Add the InsertCommand to retrieve new identity value.
adapter.InsertCommand = new SqlCommand(
"INSERT INTO dbo.Shippers (CompanyName) " +
"VALUES (@CompanyName); " +
"SELECT ShipperID, CompanyName FROM dbo.Shippers " +
"WHERE ShipperID = SCOPE_IDENTITY();", connection);
// Set AcceptChangesDuringUpdate to false
adapter.AcceptChangesDuringUpdate = false;
// Add the parameter for the inserted value.
adapter.InsertCommand.Parameters.Add(
new SqlParameter("@CompanyName", SqlDbType.NVarChar, 40,
"CompanyName"));
adapter.InsertCommand.UpdatedRowSource = UpdateRowSource.Both;
// MissingSchemaAction adds any missing schema to
// the DataTable, including auto increment columns
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;
// Fill a DataTable.
DataTable shipper = new DataTable();
adapter.Fill(shipper);
// Add a new shipper row.
DataRow newRow = shipper.NewRow();
newRow["CompanyName"] = "New Shipper";
shipper.Rows.Add(newRow);
// Add changed rows to a new DataTable. This
// DataTable will be used to update the data source.
DataTable dataChanges = shipper.GetChanges();
adapter.Update(dataChanges);
connection.Close();
Console.WriteLine("Rows after merge.");
foreach (DataRow rowBefore in shipper.Rows)
{
{
Console.WriteLine("{0}: {1}", rowBefore[0], rowBefore[1]);
}
}
// Merge the two DataTables to get new values.
shipper.Merge(dataChanges);
// Commit the changes.
shipper.AcceptChanges();
Console.WriteLine("Rows after merge.");
foreach (DataRow rowAfter in shipper.Rows)
{
{
Console.WriteLine("{0}: {1}", rowAfter[0], rowAfter[1]);
}
}
}
}
Private Sub MergeIdentityColumns(ByVal connectionString As String)
Using connection As SqlConnection = New SqlConnection( _
connectionString)
' Create the DataAdapter
Dim adapter As SqlDataAdapter = New SqlDataAdapter( _
"SELECT ShipperID, CompanyName FROM dbo.Shippers", connection)
' Add the InsertCommand to retrieve new identity value.
adapter.InsertCommand = New SqlCommand( _
"INSERT INTO dbo.Shippers (CompanyName) " & _
"VALUES (@CompanyName); " & _
"SELECT ShipperID, CompanyName FROM dbo.Shippers " & _
"WHERE ShipperID = SCOPE_IDENTITY();", _
connection)
' Set AcceptChangesDuringUpdate to false.
adapter.AcceptChangesDuringUpdate = False
' Add the parameter for the inserted value.
adapter.InsertCommand.Parameters.Add( _
New SqlParameter("@CompanyName", SqlDbType.NVarChar, 40, _
"CompanyName"))
adapter.InsertCommand.UpdatedRowSource = _
UpdateRowSource.FirstReturnedRecord
' MissingSchemaAction adds any missing schema to
' the DataTable, including auto increment columns
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey
' Fill a DataTable.
Dim shipper As New DataTable
adapter.Fill(shipper)
' Add a new shipper row.
Dim newRow As DataRow = shipper.NewRow()
newRow("CompanyName") = "New Shipper"
shipper.Rows.Add(newRow)
' Add changed rows to a new DataTable. This
' DataTable will be used to update the data source.
Dim dataChanges As DataTable = shipper.GetChanges()
' Update the data source with the modified records.
adapter.Update(dataChanges)
Console.WriteLine("Rows before merge.")
Dim rowBefore As DataRow
For Each rowBefore In shipper.Rows
Console.WriteLine("{0}: {1}", rowBefore(0), rowBefore(1))
Next
' Merge the two DataTables to get new values.
shipper.Merge(dataChanges)
' Commit the changes.
shipper.AcceptChanges()
Console.WriteLine("Rows after merge.")
Dim rowAfter As DataRow
For Each rowAfter In shipper.Rows
Console.WriteLine("{0}: {1}", rowAfter(0), rowAfter(1))
Next
End Using
End Sub
備註
在呼叫 Update 的 方法DataAdapter期間，資料庫可以將數據傳回至您的 ADO.NET 應用程式作為輸出參數，或做為結果集的第一筆傳回記錄。 ADO.NET 可以擷取這些值並在正在更新的 DataRow 中更新對應的資料行。 根據預設，ADO.NET 在更新之後呼叫 AcceptChanges 的 DataRow 方法。 不過，如果您想要將更新的數據列合併回另一個 DataTable，您可能會想要保留主鍵數據行的原始值。 例如，對應至資料庫中自動遞增數據行的主鍵數據行，例如識別數據行，可以包含資料庫指派的新值，這些值不符合 中所 DataRow指派的原始值。 根據預設，AcceptChanges會在更新之後隱含呼叫 ，而且數據列中可能已AutoIncrement由 ADO.NET 指派的值會遺失。 您可以將 屬性設定為 ，藉此防止ADO.NETAcceptChanges在 數據列上執行更新之後呼叫 ，藉此保留原始值，來保留 DataRow 中的原始值。falseAcceptChangesDuringUpdate
注意
將 AcceptChangesDuringUpdate 屬性設定為 會 false 套用至所有數據修改，而不只是插入。 如果您想要在相同的更新中編輯或刪除數據列，而且如果您想要只針對插入隱藏對的呼叫AcceptChanges，則不要將 設定falseAcceptChangesDuringUpdate為 ，而是針對 RowUpdated 的事件DataAdapter使用事件處理程式。 在事件處理程式中，您可以檢查 StatementType 以判斷資料修改是否為插入，如果 true為 ，請將 Status 的 RowUpdatedEventArgs 屬性設定為 SkipCurrentRow。 如需詳細資訊，請參閱擷取身分識別或自動編號值。
適用於
另請參閱
- 使用 DataAdapter 更新資料來源
- 合併資料集內容
- 擷取識別或自動編號值
- ADO.NET 概觀 \(部分機器翻譯\)
