DbCommandBuilder.GetInsertCommand 方法

定义

命名空间:

System.Data.Common

程序集:

netstandard.dll, System.Data.Common.dll

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

重载

名称	说明
GetInsertCommand()	获取在数据源中执行插入所需的自动生成 DbCommand 的对象。
GetInsertCommand(Boolean)	获取在数据源中执行插入所需的自动生成 DbCommand 的对象，可以选择对参数名称使用列。

注解

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

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

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

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

GetInsertCommand()

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 仍将使用上一语句中的信息，这可能不正确。 在应用程序调用UpdateGetInsertCommand或 .

另请参阅

• 使用 CommandBuilders 生成命令
• ADO.NET 概述

GetInsertCommand(Boolean)

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 仍将使用上一语句中的信息，这可能不正确。 在应用程序调用UpdateGetInsertCommand或 .

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

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

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

• 指定 A ParameterMarkerFormat 。

另请参阅

• 使用 CommandBuilders 生成命令
• ADO.NET 概述