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