ObjectDataSourceView.ExecuteInsert(IDictionary) 方法

  • 参考

定义

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

执行插入操作，方法是使用指定的 values 集合调用由 InsertMethod 属性标识的业务对象方法。

protected:
 override int ExecuteInsert(System::Collections::IDictionary ^ values);
protected override int ExecuteInsert (System.Collections.IDictionary values);
override this.ExecuteInsert : System.Collections.IDictionary -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

参数

values
IDictionary

与 IDictionary 属性一起使用以执行插入操作的参数的 InsertMethod。 如果没有与方法关联的参数，则传递 null。

返回

Int32

插入的行数；否则，如果行数未知，则为 -1。 有关详细信息，请参阅 Insert。

例外

NotSupportedException

CanInsert 属性返回 false。

InvalidOperationException

values 为 null 或空。

注解

类 ObjectDataSourceView 实现继承 ExecuteInsert 的 方法，以使用业务对象将数据插入基础数据存储。 页面开发人员和数据绑定控件作者不直接调用 ExecuteInsert 方法;而是使用公开的方法 Insert 。

在执行插入之前， OnInserting 将调用 方法来引发 Inserting 事件。 可以处理此事件以检查参数的值，并在调用 方法之前 Insert 执行任何预处理。

为了执行插入操作， ObjectDataSourceView 控件使用反射调用由 InsertMethod 属性和集合中的任何 values 关联参数标识的方法，然后执行该方法。 操作完成后， OnInserted 将调用 方法来引发 Inserted 事件。 可以处理此事件来检查任何返回值、错误代码，并执行任何后处理。

有关返回插入的行数的详细信息，请参阅 Insert。

适用于

另请参阅