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 -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer
参数
- values
- IDictionary
用于IDictionaryInsertCommand执行插入数据库操作的属性的值。 如果没有与查询关联的参数,或者 InsertCommand 属性不是参数化的 SQL 查询,则传递 null。
返回
一个值,表示插入到基础数据库中的行数。
例外
无法 SqlDataSource 与基础数据源建立连接。
当前用户没有访问数据库的正确权限。
属性 CanInsert 为 false.
注解
该 SqlDataSourceView 类实现继承 ExecuteInsert 的方法将数据插入数据库。 页面开发人员和数据绑定控件作者不会直接调用该方法 ExecuteInsert ;而是使用公开 Insert 的方法。
在执行插入操作之前, OnInserting 将调用该方法以引发 Inserting 事件。 可以处理此事件来检查参数的值,并在插入之前执行任何预处理。
若要执行插入操作,该SqlDataSourceView对象使用DbCommand文本和任何关联的InsertCommand属性生成对象InsertParameters,然后对基础数据库执行DbCommand该对象。 插入完成后, OnInserted 将调用该方法以引发 Inserted 事件。 可以处理此事件来检查任何返回值和错误代码,以及执行任何后期处理。