語言

SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) 方法

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

使用 UpdateCommand SQL 字串、集合中的所有參數 UpdateParameters ，以及指定的 keys、 values、 和 oldValues 集合中的值執行更新操作。

protected:
 override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected override int ExecuteUpdate(System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

參數

keys
IDictionary

一 IDictionary 組主鍵，與屬性一起使用 UpdateCommand 來執行資料庫更新操作。 如果查詢沒有鍵相關聯，或屬性 UpdateCommand 不是參數化的 SQL 查詢，則傳遞 null。

values
IDictionary

一個 IDictionary 與 UpdateCommand 屬性一起使用以執行更新資料庫操作的值。 如果查詢沒有參數相關，或 不是 UpdateCommand 參數化的 SQL 查詢，則傳遞 null。

oldValues
IDictionary

一個 IDictionary 代表資料庫原始值的 如果查詢沒有相關參數，或該 UpdateCommand 屬性不是參數化的 SQL 查詢，則傳遞 null。

傳回

Int32

代表底層資料庫中更新的列數值。

例外狀況

InvalidOperationException

他們 SqlDataSource 無法與底層資料來源建立連結。

-或-

ConflictDetection屬性設定為 值CompareAllValues，且不oldValues傳遞參數。

HttpException

目前使用者沒有正確的權限來存取資料庫。

NotSupportedException

IsEditable 屬性為 true。

備註

這個 SqlDataSourceView 類別實作繼承 ExecuteUpdate 的方法來更新資料庫中的資料。 頁面開發者與資料綁定控制作者不會直接呼叫此 ExecuteUpdate 方法;而是使用公開暴露 Update 的方法。

與集合中包含的keysvalues值會被評估並合併，與集合中包含的UpdateParameters任何值合併。 若屬性 ConflictDetection 設定為 CompareAllValues，集合中包含的值 oldValues 會以 和 合併格式化 OldValuesParameterFormatString 。

在執行更新操作前，會呼叫該 OnUpdating 方法來啟動 Updating 事件。 你可以處理這個事件來檢查參數值，並在更新前執行任何預處理。

執行操作時，會SqlDataSourceView利用DbCommand文字及相關UpdateCommand屬性建置物件UpdateParameters，然後對底層資料庫執行該DbCommand物件。 操作完成後，會呼叫該 OnUpdated 方法來啟動事件 Updated 。 你可以處理此事件來檢查任何回傳值和錯誤代碼，並執行後製處理。

適用於

另請參閱