共用方式為

ObjectDataSourceView.ExecuteUpdate 方法

  • 參考

定義

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

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

values
IDictionary

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

oldValues
IDictionary

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

傳回

Int32

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

例外狀況

NotSupportedException

CanInsert 屬性會傳回 false。

InvalidOperationException

oldValues 是 null 或空的，而且 ConflictDetection 設為 CompareAllValues。

備註

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

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

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

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

適用於

另請參閱