ObjectDataSourceView.ExecuteInsert(IDictionary) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
藉由呼叫由 InsertMethod 屬性所識別的商務物件方法，同時使用指定的 values 集合，執行插入作業。
protected:
override int ExecuteInsert(System::Collections::IDictionary ^ values);protected override int ExecuteInsert (System.Collections.IDictionary values);override this.ExecuteInsert : System.Collections.IDictionary -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As Integer參數
- values
- IDictionary
參數的 IDictionary，與 InsertMethod 屬性搭配使用，以執行插入作業。 如果沒有任何參數與此方法有關聯，則會傳遞 null。
傳回
插入之資料列的數目，如果數目不明，則為 -1。 如需詳細資訊，請參閱Insert。
例外狀況
CanInsert 屬性會傳回 false。
values 為 null 或是空的。
備註
類別 ObjectDataSourceView 會實作繼承 ExecuteInsert 的方法，以使用商務物件將資料插入基礎資料存放區。 頁面開發人員和資料系結控制項作者不會直接呼叫 ExecuteInsert 方法;而是使用公開的方法 Insert 。
在執行插入之前， OnInserting 會呼叫 方法來引發 Inserting 事件。 您可以處理此事件，以檢查參數的值，並在呼叫 方法之前 Insert 執行任何前置處理。
若要執行插入作業， ObjectDataSourceView 控制項會使用反映來呼叫 屬性所識別 InsertMethod 的方法，以及集合中 values 任何相關聯的參數，然後執行它。 作業完成之後， OnInserted 會呼叫 方法來引發 Inserted 事件。 您可以處理此事件來檢查任何傳回值、錯誤碼，以及執行任何後續處理。
如需傳回插入之資料列數目的詳細資訊，請參閱 Insert 。
