OleDbCommandBuilder.GetInsertCommand 方法

定义

命名空间:

System.Data.OleDb

程序集:

System.Data.OleDb.dll

包:

System.Data.OleDb v11.0.0-rc.1.26425.128

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

重载

名称	说明
GetInsertCommand()	获取在数据源中执行插入所需的自动生成 OleDbCommand 的对象。
GetInsertCommand(Boolean)	获取在数据源中执行插入所需的自动生成 OleDbCommand 的对象。

注解

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

还可以用作 GetInsertCommand 修改后的命令的基础。 例如，可以调用 GetInsertCommand 和修改 CommandTimeout 值，然后在该 OleDbDataAdapter值上显式设置该值。

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

GetInsertCommand()

Source:

OleDbCommandBuilder.cs

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

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand();

public System.Data.OleDb.OleDbCommand GetInsertCommand();

override this.GetInsertCommand : unit -> System.Data.OleDb.OleDbCommand

Public Function GetInsertCommand () As OleDbCommand

返回

OleDbCommand

执行插入所需的自动生成 OleDbCommand 的对象。

注解

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

还可以用作 GetInsertCommand 修改后的命令的基础。 例如，可以调用 GetInsertCommand 和修改 CommandTimeout 值，然后在该 OleDbDataAdapter值上显式设置该值。

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

另请参阅

• 使用 CommandBuilders 生成命令

GetInsertCommand(Boolean)

Source:

OleDbCommandBuilder.cs

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

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.OleDb.OleDbCommand GetInsertCommand(bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.OleDb.OleDbCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As OleDbCommand

参数

useColumnsForParameterNames

Boolean

如果 true生成与列名匹配的参数名称，则尽可能生成。 如果false、生成@p1@p2、等等。

返回

OleDbCommand

执行插入所需的自动生成 OleDbCommand 的对象。

注解

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

还可以用作 GetInsertCommand 修改后的命令的基础。 例如，可以调用 GetInsertCommand 和修改 CommandTimeout 值，然后在该 OleDbDataAdapter值上显式设置该值。

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

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

• ParameterNameMaxLength已指定，其长度等于或大于生成的参数名称。

• 生成的参数名称符合正则表达式中指定的 ParameterNamePattern 条件。

• 指定 A ParameterMarkerFormat 。

另请参阅

• 使用 CommandBuilders 生成命令