ObjectDataSourceView.ExecuteUpdate 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
藉由呼叫由 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
。
傳回
更新之資料列的數目;如果數目不明,則為 -1。 如需詳細資訊,請參閱Update()。
例外狀況
CanInsert 屬性會傳回 false
。
oldValues
是 null
或空的,而且 ConflictDetection 設為 CompareAllValues。
備註
類別 ObjectDataSourceView 會實作繼承 ExecuteUpdate 的方法,以使用商務物件來更新資料。 頁面開發人員和資料系結控制項作者不會直接呼叫 ExecuteUpdate 方法;而是使用公開的方法 Update 。
和 values
集合中包含的 keys
值會評估並與集合所包含的 UpdateParameters 任何值合併。
ConflictDetection如果屬性設定為 CompareAllValues 值,則集合中包含的 oldValues
值會以 OldValuesParameterFormatString 屬性格式化,也會合並。
在執行更新作業之前,會 OnUpdating 呼叫 方法來引發 Updating 事件。 您可以處理此事件來檢查參數的值,並在更新之前執行任何前置處理。 若要執行更新作業,會 ObjectDataSourceView 使用反映來呼叫 屬性所識別 UpdateMethod 的方法,以及集合中 keys
任何相關聯的參數,然後執行它。 作業完成之後, OnUpdated 會呼叫 方法來引發 Updated 事件。 您可以處理此事件來檢查任何傳回值、錯誤碼,以及執行任何後續處理。
如需傳回更新之資料列數目的詳細資訊,請參閱 Update 。