DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

对 DataSourceView 对象所表示的数据列表执行更新操作。

protected:
 virtual int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);

protected virtual int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);

abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int

Protected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

参数

keys

IDictionary

更新操作要更新的对象或行键的 IDictionary。

values

IDictionary

表示数据元素及其新值的名称/值对的 IDictionary。

oldValues

IDictionary

表示数据元素及其原始值的名称/值对的 IDictionary。

返回

Int32

已在基础数据存储中更新的项数。

例外

NotSupportedException

ExecuteUpdate(IDictionary, IDictionary, IDictionary) 操作不受 DataSourceView 支持。

示例

下面的代码示例演示扩展 DataSourceView 类的类如何替代 CanUpdate 属性和 ExecuteUpdate 方法。 此代码示例是为 DataSourceView 类提供的一个更大示例的一部分。

// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
    get {
        return false;
    }
}
protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
{
    throw new NotSupportedException();
}

   ' The CsvDataSourceView does not currently
   ' permit update operations. You can modify or
   ' extend this sample to do so.
   Public Overrides ReadOnly Property CanUpdate() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
                                              values As IDictionary, _
                                              oldValues As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteUpdate

End Class

注解

数据绑定控件可以使用 方法来检索 DataSourceView 对象并检查 属性的值CanUpdate，从而确定数据源控件DataSourceControl.GetView是否ExecuteUpdate支持该操作。

参数 keys 表示要更新的数据的对象或行键。 对于表示关系数据的数据源（如 SqlDataSource 控件）， keys 参数是数据库主键的集合。 在其他方案中， keys 参数是名称/值对的集合，用于筛选数据列表。 任何与名称/值对匹配的数据都会使用 参数中找到 values 的值进行更新，参数是一组表示现有字段或列的新值的名称/值对。

注意

类 DataSourceView 的默认实现是引发 NotSupportedException 异常。 如果扩展 DataSourceView 类，如果类支持更新基础数据存储中的数据，请重写 ExecuteUpdate 方法。

另请参阅

• CanUpdate