共用方式為


ObjectDataSourceView.ExecuteInsert(IDictionary) 方法

定義

藉由呼叫由 InsertMethod 屬性所識別的商務物件方法,同時使用指定的 values 集合,執行插入作業。

protected:
 override int ExecuteInsert(System::Collections::IDictionary ^ values);
protected override int ExecuteInsert (System.Collections.IDictionary values);
override this.ExecuteInsert : System.Collections.IDictionary -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

參數

values
IDictionary

參數的 IDictionary,與 InsertMethod 屬性搭配使用,以執行插入作業。 如果沒有任何參數與此方法有關聯,則會傳遞 null

傳回

插入之資料列的數目,如果數目不明,則為 -1。 如需詳細資訊,請參閱Insert

例外狀況

CanInsert 屬性會傳回 false

valuesnull 或是空的。

備註

類別 ObjectDataSourceView 會實作繼承 ExecuteInsert 的方法,以使用商務物件將資料插入基礎資料存放區。 頁面開發人員和資料系結控制項作者不會直接呼叫 ExecuteInsert 方法;而是使用公開的方法 Insert

在執行插入之前, OnInserting 會呼叫 方法來引發 Inserting 事件。 您可以處理此事件,以檢查參數的值,並在呼叫 方法之前 Insert 執行任何前置處理。

若要執行插入作業, ObjectDataSourceView 控制項會使用反映來呼叫 屬性所識別 InsertMethod 的方法,以及集合中 values 任何相關聯的參數,然後執行它。 作業完成之後, OnInserted 會呼叫 方法來引發 Inserted 事件。 您可以處理此事件來檢查任何傳回值、錯誤碼,以及執行任何後續處理。

如需傳回插入之資料列數目的詳細資訊,請參閱 Insert

適用於

另請參閱