SqlDataSourceView.ExecuteInsert(IDictionary) 方法

  • 参考

定义

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

使用 InsertCommand SQL 字符串、InsertParameters 集合中指定的所有参数，以及指定的 values 集合中的值执行插入操作。

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 属性一起使用以执行插入数据库操作的值的 InsertCommand。 如果不存在与查询关联的参数，或者如果 InsertCommand 属性不是参数化 SQL 查询，则传递 null。

返回

Int32

一个值，该值表示插入到基础数据库中的行数。

例外

InvalidOperationException

SqlDataSource 无法与基础数据源建立连接。

HttpException

当前用户不具有访问数据库的正确权限。

NotSupportedException

CanInsert 属性为 false。

注解

类 SqlDataSourceView 实现继承 ExecuteInsert 的方法以将数据插入数据库。 页面开发人员和数据绑定控件作者不会直接调用 ExecuteInsert 方法;而是使用公开的方法 Insert 。

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

为了执行插入操作，SqlDataSourceView对象使用InsertCommand文本和任何关联的InsertParameters属性生成对象DbCommand，然后针对基础数据库执行DbCommand对象。 插入完成后， OnInserted 将调用 方法来引发 Inserted 事件。 可以处理此事件以检查任何返回值和错误代码，并执行任何后期处理。

适用于

另请参阅