SqlDataSourceView.ExecuteInsert(IDictionary) 方法

定义

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

用于IDictionaryInsertCommand执行插入数据库操作的属性的值。 如果没有与查询关联的参数,或者 InsertCommand 属性不是参数化的 SQL 查询,则传递 null

返回

一个值,表示插入到基础数据库中的行数。

例外

无法 SqlDataSource 与基础数据源建立连接。

当前用户没有访问数据库的正确权限。

属性 CanInsertfalse.

注解

SqlDataSourceView 类实现继承 ExecuteInsert 的方法将数据插入数据库。 页面开发人员和数据绑定控件作者不会直接调用该方法 ExecuteInsert ;而是使用公开 Insert 的方法。

在执行插入操作之前, OnInserting 将调用该方法以引发 Inserting 事件。 可以处理此事件来检查参数的值,并在插入之前执行任何预处理。

若要执行插入操作,该SqlDataSourceView对象使用DbCommand文本和任何关联的InsertCommand属性生成对象InsertParameters,然后对基础数据库执行DbCommand该对象。 插入完成后, OnInserted 将调用该方法以引发 Inserted 事件。 可以处理此事件来检查任何返回值和错误代码,以及执行任何后期处理。

适用于

另请参阅