ObjectDataSourceView.ExecuteUpdate 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
通过调用由 UpdateMethod 属性标识的方法和使用 keys
、values
或 oldValues
集合中提供的所有参数以执行更新操作。
protected:
override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected override int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer
参数
- keys
- IDictionary
与 IDictionary 属性一起使用以执行更新数据库操作的主键的 UpdateMethod。 如果没有与方法关联的键,则传递 null
。
- values
- IDictionary
与 IDictionary 一起使用以执行更新数据库操作的值的 UpdateMethod。 如果没有与方法关联的参数,则传递 null
。
- oldValues
- IDictionary
表示基础数据存储区中的原始值的 IDictionary。 如果没有与查询关联的参数,则传递 null
。
返回
更新的行数;如果行数未知,则为 -1。 有关详细信息,请参阅 Update()。
例外
CanInsert 属性返回 false
。
oldValues
为 null
或为空,并将 ConflictDetection 设置为 CompareAllValues。
注解
类 ObjectDataSourceView 实现继承 ExecuteUpdate 的 方法,以使用业务对象更新数据。 页面开发人员和数据绑定控件作者不直接调用 ExecuteUpdate 方法;而是使用公开的方法 Update 。
将计算 包含在 和 values
集合中的keys
值,并将其与集合包含UpdateParameters的任何值合并。 如果 属性 ConflictDetection 设置为 CompareAllValues 值,则集合中包含的 oldValues
值将采用 OldValuesParameterFormatString 属性进行格式设置,并且也会合并。
在执行更新操作之前, OnUpdating 将调用 方法来引发 Updating 事件。 可以处理此事件来检查参数的值,并在更新之前执行任何预处理。 若要执行更新操作, ObjectDataSourceView 使用反射调用由 UpdateMethod 属性和集合中的任何 keys
关联参数标识的方法,然后执行该方法。 操作完成后, OnUpdated 将调用 方法来引发 Updated 事件。 可以处理此事件来检查任何返回值、错误代码,并执行任何后处理。
有关返回更新的行数的详细信息,请参阅 Update。