OdbcCommandBuilder.GetInsertCommand 方法

定义

命名空间:

System.Data.Odbc

程序集:

System.Data.Odbc.dll

包:

System.Data.Odbc v9.0.0

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

重载

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

注解

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

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

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

GetInsertCommand()

Source:

OdbcCommandBuilder.cs

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

public:
 System::Data::Odbc::OdbcCommand ^ GetInsertCommand();

public System.Data.Odbc.OdbcCommand GetInsertCommand ();

override this.GetInsertCommand : unit -> System.Data.Odbc.OdbcCommand

Public Function GetInsertCommand () As OdbcCommand

返回

OdbcCommand

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

注解

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

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

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

另请参阅

• 使用 CommandBuilder 生成命令

GetInsertCommand(Boolean)

Source:

OdbcCommandBuilder.cs

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

public:
 System::Data::Odbc::OdbcCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.Odbc.OdbcCommand GetInsertCommand (bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.Odbc.OdbcCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As OdbcCommand

参数

useColumnsForParameterNames

Boolean

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

返回

OdbcCommand

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

注解

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

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

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

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

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

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

• ParameterMarkerFormat指定了 。

另请参阅

• 使用 CommandBuilder 生成命令