DataSourceView.ExecuteInsert(IDictionary) 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

对 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 -> int

Protected Overridable Function ExecuteInsert (values As IDictionary) As Integer

参数

values

IDictionary

在插入操作期间使用的名称/值对的 IDictionary。

返回

Int32

已插入到基础数据存储中的项数。

例外

NotSupportedException

ExecuteInsert(IDictionary) 操作不受 DataSourceView 支持。

示例

下面的代码示例演示扩展 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 方法。

另请参阅

• CanInsert