DataSourceView.ExecuteInsert(IDictionary) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
对 DataSourceView 对象所表示的数据列表执行插入操作。
protected:
virtual int ExecuteInsert(System::Collections::IDictionary ^ values);protected virtual int ExecuteInsert (System.Collections.IDictionary values);abstract member ExecuteInsert : System.Collections.IDictionary -> int
override this.ExecuteInsert : System.Collections.IDictionary -> intProtected Overridable Function ExecuteInsert (values As IDictionary) As Integer参数
- values
- IDictionary
在插入操作期间使用的名称/值对的 IDictionary。
返回
已插入到基础数据存储中的项数。
例外
示例
下面的代码示例演示扩展 DataSourceView 类的类如何重写 CanInsert 属性和 ExecuteInsert 方法。 此代码示例是为 DataSourceView 类提供的一个更大示例的一部分。
// The CsvDataSourceView does not currently
// permit insertion of a new record. You can
// modify or extend this sample to do so.
public override bool CanInsert {
get {
return false;
}
}
protected override int ExecuteInsert(IDictionary values)
{
throw new NotSupportedException();
}
' The CsvDataSourceView does not currently
' permit insertion of a new record. You can
' modify or extend this sample to do so.
Public Overrides ReadOnly Property CanInsert() As Boolean
Get
Return False
End Get
End Property
Protected Overrides Function ExecuteInsert(values As IDictionary) As Integer
Throw New NotSupportedException()
End Function 'ExecuteInsert
注解
数据绑定控件可以通过使用 GetView 方法检索 DataSourceView 对象并检查 属性来确定数据源控件是否ExecuteInsert支持该CanInsert操作。
参数 values 是一组名称/值对，表示要插入的数据列或字段以及相应的值。
注意
类 DataSourceView 的默认实现是引发 NotSupportedException 异常。 如果扩展 DataSourceView 类，如果类支持插入基础数据存储，请重写 ExecuteInsert 方法。
