SqlCommandBuilder.GetInsertCommand 方法

定义

重载

GetInsertCommand()

获取自动生成的、对数据库执行插入操作所需的 SqlCommand 对象。

GetInsertCommand(Boolean)

获取自动生成的、对数据库执行插入操作所需的 SqlCommand 对象。

GetInsertCommand()

获取自动生成的、对数据库执行插入操作所需的 SqlCommand 对象。

public:
 Microsoft::Data::SqlClient::SqlCommand ^ GetInsertCommand();
public Microsoft.Data.SqlClient.SqlCommand GetInsertCommand ();
member this.GetInsertCommand : unit -> Microsoft.Data.SqlClient.SqlCommand
override this.GetInsertCommand : unit -> Microsoft.Data.SqlClient.SqlCommand
Public Function GetInsertCommand () As SqlCommand

返回

自动生成的、执行插入操作所需的 SqlCommand 对象。

注解

应用程序可以将 GetInsertCommand 方法用于信息性或故障排除目的, SqlCommand 因为它返回要执行的对象。

还可以使用 GetInsertCommand 作为已修改命令的基础。 例如,可以调用 GetInsertCommand 并修改 CommandTimeout 值,然后在 上 SqlDataAdapter显式设置该值。

首次生成 Transact-SQL 语句后,如果应用程序以任何方式更改语句,则必须显式调用 RefreshSchema 。 否则, GetInsertCommand 仍将使用上一语句中的信息,这可能不正确。 当应用程序调用 UpdateGetInsertCommand时,首先生成 Transact-SQL 语句。

有关详细信息,请参阅使用 CommandBuilders 生成命令

适用于

GetInsertCommand(Boolean)

获取自动生成的、对数据库执行插入操作所需的 SqlCommand 对象。

public:
 Microsoft::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);
public Microsoft.Data.SqlClient.SqlCommand GetInsertCommand (bool useColumnsForParameterNames);
member this.GetInsertCommand : bool -> Microsoft.Data.SqlClient.SqlCommand
override this.GetInsertCommand : bool -> Microsoft.Data.SqlClient.SqlCommand
Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

参数

useColumnsForParameterNames
Boolean

如果为 true,则生成与列名匹配的参数名(如果可能)。 如果为 false,则生成 @p1@p2,以此类推。

返回

自动生成的、执行插入操作所需的 SqlCommand 对象。

注解

应用程序可以将 GetInsertCommand 方法用于信息性或故障排除目的, SqlCommand 因为它返回要执行的对象。

还可以使用 GetInsertCommand 作为已修改命令的基础。 例如,可以调用 GetInsertCommand 并修改 CommandTimeout 值,然后在 上 SqlDataAdapter显式设置该值。

首次生成 Transact-SQL 语句后,如果应用程序以任何方式更改语句,则必须显式调用 RefreshSchema 。 否则, GetInsertCommand 仍将使用上一语句中的信息,这可能不正确。 当应用程序调用 UpdateGetInsertCommand时,首先生成 Transact-SQL 语句。

生成参数名称时的默认行为是对各种参数使用 @p1@p2等。 通过 trueuseColumnsForParameterNames 参数传递,可以强制 OleDbCommandBuilder 根据列名称生成参数。 仅当满足以下条件时,此操作才会成功:

有关详细信息,请参阅使用 CommandBuilders 生成命令

适用于