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 事件。 可以处理此事件以检查任何返回值和错误代码，并执行任何后期处理。
