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