Share via

ObjectDataSourceView.ExecuteInsert(IDictionary) 方法

  • 參考

定義

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

藉由呼叫由 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。

傳回

Int32

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

例外狀況

NotSupportedException

CanInsert 屬性會傳回 false。

InvalidOperationException

values 為 null 或是空的。

備註

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

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

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

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

適用於

另請參閱