SqlCommandBuilder.GetUpdateCommand 方法

public:
 System::Data::SqlClient::SqlCommand ^ GetUpdateCommand();

public System.Data.SqlClient.SqlCommand GetUpdateCommand ();

override this.GetUpdateCommand : unit -> System.Data.SqlClient.SqlCommand

member this.GetUpdateCommand : unit -> System.Data.SqlClient.SqlCommand

Public Function GetUpdateCommand () As SqlCommand

返回

自动生成的、执行更新所需的 SqlCommand 对象。

注解

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

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

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

有关详细信息，请参阅使用 CommandBuilders 生成命令。

另请参阅

• 在 ADO.NET 中连接和检索数据
• 使用适用于 SQL Server 的 .NET Framework 数据提供程序
• ADO.NET 概述

public:
 System::Data::SqlClient::SqlCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);

public System.Data.SqlClient.SqlCommand GetUpdateCommand (bool useColumnsForParameterNames);

override this.GetUpdateCommand : bool -> System.Data.SqlClient.SqlCommand

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommand

参数

返回

自动生成的、执行更新所需的 SqlCommand 对象。

注解

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

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

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

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

• ParameterNameMaxLength从 GetSchema 方法调用返回并在集合中找到的 DataSourceInformation 已指定，其长度等于或大于生成的参数名称。

• 生成的参数名称满足从 GetSchema 方法调用返回的 中指定的ParameterNamePattern条件，并在集合正则表达式中找到DataSourceInformation。

• ParameterMarkerFormat指定了从 GetSchema 方法调用返回并在集合中找到的 DataSourceInformation 。

有关详细信息，请参阅使用 CommandBuilders 生成命令。

另请参阅

• 在 ADO.NET 中连接和检索数据
• 使用适用于 SQL Server 的 .NET Framework 数据提供程序
• ADO.NET 概述