SqlDataSourceView.ExecuteInsert(IDictionary) 方法

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

使用 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 -> int

Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

參數

values

IDictionary

值的 IDictionary，與 InsertCommand 屬性搭配使用，以執行插入資料庫作業。 如果沒有任何參數與查詢關聯，或 InsertCommand 屬性不是參數型的 SQL 查詢，則會傳遞 null。

傳回

Int32

表示插入基礎資料庫之資料列數的值。

例外狀況

InvalidOperationException

SqlDataSource 不能以基礎資料來源建立連接。

HttpException

目前的使用者不具有取得資料庫存取權的正確使用權限。

NotSupportedException

CanInsert 屬性為 false。

備註

類別 SqlDataSourceView 會實作繼承 ExecuteInsert 的方法，以將資料插入資料庫。 頁面開發人員和資料系結控制項作者不會直接呼叫 ExecuteInsert 方法;而是使用公開的方法 Insert 。

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

若要執行插入作業， SqlDataSourceView 物件會使用 InsertCommand 文字和任何相關聯的 InsertParameters 屬性來建置 DbCommand 物件，然後針對基礎資料庫執行 DbCommand 物件。 插入完成之後， OnInserted 會呼叫 方法來引發 Inserted 事件。 您可以處理此事件來檢查任何傳回值和錯誤碼，以及執行任何後續處理。

另請參閱

• Insert(IDictionary)
• InsertCommand
• InsertParameters