SqlDataSourceView.ExecuteInsert(IDictionary) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
使用 InsertCommand SQL 字串、InsertParameters 集合中指定的任何參數，以及 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，與 InsertCommand 屬性搭配使用，以執行插入資料庫作業。 如果沒有任何參數與查詢關聯，或 InsertCommand 屬性不是參數型的 SQL 查詢，則會傳遞 null。
傳回
表示插入基礎資料庫之資料列數的值。
例外狀況
SqlDataSource 不能以基礎資料來源建立連接。
目前的使用者不具有取得資料庫存取權的正確使用權限。
CanInsert 屬性為 false。
備註
類別 SqlDataSourceView 會實作繼承 ExecuteInsert 的方法，以將資料插入資料庫。 頁面開發人員和資料系結控制項作者不會直接呼叫 ExecuteInsert 方法;而是使用公開的方法 Insert 。
在執行插入作業之前，會 OnInserting 呼叫 方法來引發 Inserting 事件。 您可以處理此事件來檢查參數的值，並在插入之前執行任何前置處理。
若要執行插入作業， SqlDataSourceView 物件會使用 InsertCommand 文字和任何相關聯的 InsertParameters 屬性來建置 DbCommand 物件，然後針對基礎資料庫執行 DbCommand 物件。 插入完成之後， OnInserted 會呼叫 方法來引發 Inserted 事件。 您可以處理此事件來檢查任何傳回值和錯誤碼，以及執行任何後續處理。
