DbCommandBuilder.GetInsertCommand 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取在数据源中执行插入所需的自动生成 DbCommand 的对象。
重载
| 名称 | 说明 |
|---|---|
| GetInsertCommand() |
获取在数据源中执行插入所需的自动生成 DbCommand 的对象。 |
| GetInsertCommand(Boolean) |
获取在数据源中执行插入所需的自动生成 DbCommand 的对象,可以选择对参数名称使用列。 |
注解
应用程序可以使用该方法 GetInsertCommand 进行信息化或故障排除,因为它返回要执行的对象的文本 DbCommand 。
还可以用作 GetInsertCommand 修改后的命令的基础。 例如,可以调用 GetInsertCommand 和修改命令文本,然后在该命令上显式设置该文本 DbDataAdapter。
首次生成 SQL 语句后,如果应用程序以任何方式更改语句,则必须显式调用 RefreshSchema 该应用程序。 否则, GetInsertCommand 仍将使用上一语句中的信息,这可能不正确。 在应用程序调用UpdateGetInsertCommand或 .
生成参数名称时的默认行为是使用@p1@p2各种参数等。 如果重载版本的 GetInsertCommand 允许指定此行为,则可能会导致 DbCommandBuilder 基于列名生成参数。
GetInsertCommand()
获取在数据源中执行插入所需的自动生成 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 的对象。
注解
应用程序可以使用该方法 GetInsertCommand 进行信息化或故障排除,因为它返回要执行的对象的文本 DbCommand 。
还可以用作 GetInsertCommand 修改后的命令的基础。 例如,可以调用 GetInsertCommand 和修改命令文本,然后在该命令上显式设置该文本 DbDataAdapter。
首次生成 SQL 语句后,如果应用程序以任何方式更改语句,则必须显式调用 RefreshSchema 该应用程序。 否则, GetInsertCommand 仍将使用上一语句中的信息,这可能不正确。 在应用程序调用UpdateGetInsertCommand或 .
另请参阅
适用于
GetInsertCommand(Boolean)
获取在数据源中执行插入所需的自动生成 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 的对象。
注解
应用程序可以使用该方法 GetInsertCommand 进行信息化或故障排除,因为它返回要执行的对象的文本 DbCommand 。
还可以用作 GetInsertCommand 修改后的命令的基础。 例如,可以调用 GetInsertCommand 和修改命令文本,然后在该命令上显式设置该文本 DbDataAdapter。
首次生成 SQL 语句后,如果应用程序以任何方式更改语句,则必须显式调用 RefreshSchema 该应用程序。 否则, GetInsertCommand 仍将使用上一语句中的信息,这可能不正确。 在应用程序调用UpdateGetInsertCommand或 .
生成参数名称时的默认行为是使用@p1@p2各种参数等。
true通过传递参数useColumnsForParameterNames,可以强制DbCommandBuilder基于列名生成参数。 仅当满足以下条件时,基于列名的参数生成才会成功:
ParameterNameMaxLength已指定,其长度等于或大于生成的参数名称。
生成的参数名称符合正则表达式中指定的 ParameterNamePattern 条件。
指定 A ParameterMarkerFormat 。