SqlCommandBuilder.GetInsertCommand 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取对数据库执行插入所需的自动生成 SqlCommand 的对象。
重载
| 名称 | 说明 |
|---|---|
| GetInsertCommand() |
获取对数据库执行插入所需的自动生成 SqlCommand 的对象。 |
| GetInsertCommand(Boolean) |
获取对数据库执行插入所需的自动生成 SqlCommand 的对象。 |
注解
应用程序可以使用 GetInsertCommand 该方法进行信息性或故障排除目的，因为它返回 SqlCommand 要执行的对象。
还可以用作 GetInsertCommand 修改后的命令的基础。 例如，可以调用 GetInsertCommand 和修改 CommandTimeout 值，然后在该 SqlDataAdapter值上显式设置该值。
首次生成 Transact-SQL 语句后，如果应用程序以任何方式更改语句，则必须显式调用 RefreshSchema。 否则， GetInsertCommand 仍将使用上一语句中的信息，这可能不正确。 应用程序调用 Update 或 GetInsertCommand 时，首先生成 Transact-SQL 语句。
有关详细信息，请参阅使用 CommandBuilders 生成命令。
GetInsertCommand()
获取对数据库执行插入所需的自动生成 SqlCommand 的对象。
public:
System::Data::SqlClient::SqlCommand ^ GetInsertCommand();public System.Data.SqlClient.SqlCommand GetInsertCommand();member this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommandoverride this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommandPublic Function GetInsertCommand () As SqlCommand返回
执行插入所需的自动生成 SqlCommand 的对象。
注解
应用程序可以使用 GetInsertCommand 该方法进行信息性或故障排除目的，因为它返回 SqlCommand 要执行的对象。
还可以用作 GetInsertCommand 修改后的命令的基础。 例如，可以调用 GetInsertCommand 和修改 CommandTimeout 值，然后在该 SqlDataAdapter值上显式设置该值。
首次生成 Transact-SQL 语句后，如果应用程序以任何方式更改语句，则必须显式调用 RefreshSchema。 否则， GetInsertCommand 仍将使用上一语句中的信息，这可能不正确。 应用程序调用 Update 或 GetInsertCommand 时，首先生成 Transact-SQL 语句。
有关详细信息，请参阅使用 CommandBuilders 生成命令。
另请参阅
适用于
GetInsertCommand(Boolean)
获取对数据库执行插入所需的自动生成 SqlCommand 的对象。
public:
System::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);public System.Data.SqlClient.SqlCommand GetInsertCommand(bool useColumnsForParameterNames);override this.GetInsertCommand : bool -> System.Data.SqlClient.SqlCommandPublic Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand参数
- useColumnsForParameterNames
- Boolean
如果 true可能，请生成与列名匹配的参数名称。 如果false、生成@p1@p2、等等。
返回
执行插入所需的自动生成 SqlCommand 的对象。
注解
应用程序可以使用 GetInsertCommand 该方法进行信息性或故障排除目的，因为它返回 SqlCommand 要执行的对象。
还可以用作 GetInsertCommand 修改后的命令的基础。 例如，可以调用 GetInsertCommand 和修改 CommandTimeout 值，然后在该 SqlDataAdapter值上显式设置该值。
首次生成 Transact-SQL 语句后，如果应用程序以任何方式更改语句，则必须显式调用 RefreshSchema。 否则， GetInsertCommand 仍将使用上一语句中的信息，这可能不正确。 应用程序调用 Update 或 GetInsertCommand 时，首先生成 Transact-SQL 语句。
生成参数名称时的默认行为是使用@p1@p2各种参数等。 通过 true 为 useColumnsForParameterNames 参数传递，可以强制 OleDbCommandBuilder 基于列名生成参数。 仅当满足以下条件时，才会成功：
ParameterNameMaxLength从 GetSchema 方法调用返回并在集合中找到DataSourceInformation的已指定值，其长度等于或大于生成的参数名称。
生成的参数名称符合 GetSchema 方法调用中ParameterNamePattern返回的条件，并在集合正则表达式中找到DataSourceInformation。
ParameterMarkerFormat从 GetSchema 方法调用返回并在集合中找到的DataSourceInformation已指定。
有关详细信息，请参阅使用 CommandBuilders 生成命令。