DbCommandBuilder.GetInsertCommand 方法

  • 参考

定义

命名空间:
System.Data.Common
程序集:
System.Data.Common.dll
程序集:
System.Data.dll
程序集:
netstandard.dll

获取在数据源中执行插入操作所需的自动生成的 DbCommand 对象。

重载

GetInsertCommand()

获取在数据源中执行插入操作所需的自动生成的 DbCommand 对象。
GetInsertCommand(Boolean)

获取对数据源执行插入操作所必需的自动生成的 DbCommand 对象，可选择使用列作为参数名。

注解

应用程序可以使用 GetInsertCommand 方法进行信息性或故障排除，因为它返回要执行的对象的文本 DbCommand 。

还可以使用 GetInsertCommand 作为已修改命令的基础。 例如，可以调用 GetInsertCommand 并修改命令文本，然后在 上 DbDataAdapter显式设置。

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

生成参数名称时的默认行为是对各种参数使用 @p1、 @p2等。 如果 的 GetInsertCommand 重载版本允许指定此行为，则可以改为使 DbCommandBuilder 生成基于列名称的参数。

GetInsertCommand()

Source:
DBCommandBuilder.cs
Source:
DBCommandBuilder.cs
Source:
DBCommandBuilder.cs

获取在数据源中执行插入操作所需的自动生成的 DbCommand 对象。

public:
 System::Data::Common::DbCommand ^ GetInsertCommand();
public System.Data.Common.DbCommand GetInsertCommand ();
member this.GetInsertCommand : unit -> System.Data.Common.DbCommand
Public Function GetInsertCommand () As DbCommand

返回

DbCommand

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

注解

应用程序可以使用 GetInsertCommand 方法进行信息性或故障排除，因为它返回要执行的对象的文本 DbCommand 。

还可以使用 GetInsertCommand 作为已修改命令的基础。 例如，可以调用 GetInsertCommand 并修改命令文本，然后在 上 DbDataAdapter显式设置。

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

另请参阅

适用于

GetInsertCommand(Boolean)

Source:
DBCommandBuilder.cs
Source:
DBCommandBuilder.cs
Source:
DBCommandBuilder.cs

获取对数据源执行插入操作所必需的自动生成的 DbCommand 对象，可选择使用列作为参数名。

public:
 System::Data::Common::DbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);
public System.Data.Common.DbCommand GetInsertCommand (bool useColumnsForParameterNames);
member this.GetInsertCommand : bool -> System.Data.Common.DbCommand
Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As DbCommand

参数

useColumnsForParameterNames
Boolean

如果为 true，则生成与列名匹配的参数名（如果可能）。 如果为 false，则生成 @p1、@p2，以此类推。

返回

DbCommand

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

注解

应用程序可以使用 GetInsertCommand 方法进行信息性或故障排除，因为它返回要执行的对象的文本 DbCommand 。

还可以使用 GetInsertCommand 作为已修改命令的基础。 例如，可以调用 GetInsertCommand 并修改命令文本，然后在 上 DbDataAdapter显式设置。

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

生成参数名称时的默认行为是对各种参数使用 @p1、 @p2等。 通过 true 为 useColumnsForParameterNames 参数传递，可以强制 DbCommandBuilder 根据列名称生成参数。 仅当满足以下条件时，基于列名称的参数生成才成功：

另请参阅

适用于