共用方式為


ObjectDataSourceView.ExecuteUpdate 方法

定義

藉由呼叫由 UpdateMethod 屬性所識別的方法,同時使用 keysvaluesoldValues 集合中提供的任何參數,執行更新作業。

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,與 UpdateMethod 屬性搭配使用,以執行更新資料庫作業。 如果沒有與方法關聯的索引鍵,則會傳遞 null

values
IDictionary

值的 IDictionary,與 UpdateMethod 搭配使用,以執行更新資料庫作業。 如果沒有任何參數與此方法有關聯,則會傳遞 null

oldValues
IDictionary

IDictionary,表示基礎資料存放區中的原始值。 如果沒有與查詢關聯的參數,則會傳遞 null

傳回

更新之資料列的數目;如果數目不明,則為 -1。 如需詳細資訊,請參閱Update()

例外狀況

CanInsert 屬性會傳回 false

oldValuesnull 或空的,而且 ConflictDetection 設為 CompareAllValues

備註

類別 ObjectDataSourceView 會實作繼承 ExecuteUpdate 的方法,以使用商務物件來更新資料。 頁面開發人員和資料系結控制項作者不會直接呼叫 ExecuteUpdate 方法;而是使用公開的方法 Update

values 集合中包含的 keys 值會評估並與集合所包含的 UpdateParameters 任何值合併。 ConflictDetection如果屬性設定為 CompareAllValues 值,則集合中包含的 oldValues 值會以 OldValuesParameterFormatString 屬性格式化,也會合並。

在執行更新作業之前,會 OnUpdating 呼叫 方法來引發 Updating 事件。 您可以處理此事件來檢查參數的值,並在更新之前執行任何前置處理。 若要執行更新作業,會 ObjectDataSourceView 使用反映來呼叫 屬性所識別 UpdateMethod 的方法,以及集合中 keys 任何相關聯的參數,然後執行它。 作業完成之後, OnUpdated 會呼叫 方法來引發 Updated 事件。 您可以處理此事件來檢查任何傳回值、錯誤碼,以及執行任何後續處理。

如需傳回更新之資料列數目的詳細資訊,請參閱 Update

適用於

另請參閱