ObjectDataSourceView.ExecuteInsert(IDictionary) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
执行插入操作,方法是使用指定的 values
集合调用由 InsertMethod 属性标识的业务对象方法。
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 属性一起使用以执行插入操作的参数的 InsertMethod。 如果没有与方法关联的参数,则传递 null
。
返回
插入的行数;否则,如果行数未知,则为 -1。 有关详细信息,请参阅 Insert。
例外
CanInsert 属性返回 false
。
values
为 null
或空。
注解
类 ObjectDataSourceView 实现继承 ExecuteInsert 的 方法,以使用业务对象将数据插入基础数据存储。 页面开发人员和数据绑定控件作者不直接调用 ExecuteInsert 方法;而是使用公开的方法 Insert 。
在执行插入之前, OnInserting 将调用 方法来引发 Inserting 事件。 可以处理此事件以检查参数的值,并在调用 方法之前 Insert 执行任何预处理。
为了执行插入操作, ObjectDataSourceView 控件使用反射调用由 InsertMethod 属性和集合中的任何 values
关联参数标识的方法,然后执行该方法。 操作完成后, OnInserted 将调用 方法来引发 Inserted 事件。 可以处理此事件来检查任何返回值、错误代码,并执行任何后处理。
有关返回插入的行数的详细信息,请参阅 Insert。