SqlCommandBuilder.GetUpdateCommand 方法

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.dll

套件:

Microsoft.Data.SqlClient v5.2.0

多載

GetUpdateCommand()	取得在資料庫上執行更新時所需之自動產生的 SqlCommand 物件。
GetUpdateCommand(Boolean)	取得在資料庫上執行更新時所需之自動產生的 SqlCommand 物件。

GetUpdateCommand()

取得在資料庫上執行更新時所需之自動產生的 SqlCommand 物件。

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

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

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

Public Function GetUpdateCommand () As SqlCommand

傳回

SqlCommand

執行更新時所需之自動產生的 SqlCommand 物件。

備註

應用程式可以使用 GetUpdateCommand 方法進行參考或疑難排解，因為它會傳回 SqlCommand 要執行的物件。

您也可以使用 GetUpdateCommand 做為已修改命令的基礎。 例如，您可以呼叫 GetUpdateCommand 和修改 CommandTimeout 值，然後在 上 SqlDataAdapter 明確設定該值。

第一次產生 Transact-SQL 語句之後，如果應用程式以任何方式變更語句，就必須明確呼叫 RefreshSchema 。 否則， GetUpdateCommand 仍會使用上一個語句中的資訊，可能不正確。 當應用程式呼叫 Update 或 GetUpdateCommand 時，會先產生 Transact-SQL 語句。

如需詳細資訊，請參閱使用 CommandBuilder 產生命令。

GetUpdateCommand(Boolean)

取得在資料庫上執行更新時所需之自動產生的 SqlCommand 物件。

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

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

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

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommand

參數

useColumnsForParameterNames

Boolean

如果為 true，則盡可能產生符合資料行名稱的參數名稱。 如為 false，則產生 @p1、@p2 等等。

傳回

SqlCommand

自動產生的 SqlCommand 物件，執行更新時所需要的。

備註

應用程式可以使用 GetUpdateCommand 方法進行參考或疑難排解，因為它會傳回 SqlCommand 要執行的物件。

您也可以使用 GetUpdateCommand 做為已修改命令的基礎。 例如，您可以呼叫 GetUpdateCommand 和修改 CommandTimeout 值，然後在 上 SqlDataAdapter 明確設定該值。

第一次產生 Transact-SQL 語句之後，如果應用程式以任何方式變更語句，就必須明確呼叫 RefreshSchema 。 否則， GetUpdateCommand 仍會使用上一個語句中的資訊，可能不正確。 當應用程式呼叫 Update 或 GetUpdateCommand 時，會先產生 Transact-SQL 語句。

產生參數名稱時的預設行為是針對各種參數使用 @p1 、 @p2 等等。 trueuseColumnsForParameterNames 傳遞 參數可讓您強制 OleDbCommandBuilder 改為根據資料行名稱產生參數。 只有在符合下列條件時，才會成功：

• ParameterNameMaxLength從GetSchema方法呼叫傳回且在集合中找到 DataSourceInformation 的 ，其長度等於或大於產生的參數名稱。

• 產生的參數名稱符合從 GetSchema方法呼叫傳回之 中指定的 ParameterNamePattern 準則，並在集合正則運算式中找到 DataSourceInformation 。

• ParameterMarkerFormat從GetSchema方法呼叫傳回，並在集合中找到的 DataSourceInformation 已指定 。

如需詳細資訊，請參閱使用 CommandBuilder 產生命令。