ObjectDataSourceView.ExecuteUpdate 方法

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

通过调用由 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。

返回

Int32

更新的行数；如果行数未知，则为 -1。 有关详细信息，请参阅 Update()。

例外

NotSupportedException

CanInsert 属性返回 false。

InvalidOperationException

oldValues 为 null 或为空，并将 ConflictDetection 设置为 CompareAllValues。

注解

类 ObjectDataSourceView 实现继承 ExecuteUpdate 的 方法，以使用业务对象更新数据。 页面开发人员和数据绑定控件作者不直接调用 ExecuteUpdate 方法;而是使用公开的方法 Update 。

将计算 包含在 和 values 集合中的keys值，并将其与集合包含UpdateParameters的任何值合并。 如果 属性 ConflictDetection 设置为 CompareAllValues 值，则集合中包含的 oldValues 值将采用 OldValuesParameterFormatString 属性进行格式设置，并且也会合并。

在执行更新操作之前， OnUpdating 将调用 方法来引发 Updating 事件。 可以处理此事件来检查参数的值，并在更新之前执行任何预处理。 若要执行更新操作， ObjectDataSourceView 使用反射调用由 UpdateMethod 属性和集合中的任何 keys 关联参数标识的方法，然后执行该方法。 操作完成后， OnUpdated 将调用 方法来引发 Updated 事件。 可以处理此事件来检查任何返回值、错误代码，并执行任何后处理。

有关返回更新的行数的详细信息，请参阅 Update。

适用于

另请参阅