DbCommandBuilder.GetUpdateCommand 方法

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

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

多載

GetUpdateCommand()	取得在資料來源上執行更新時所需之自動產生的 DbCommand 物件。
GetUpdateCommand(Boolean)	選擇性地使用參數名稱的資料行，取得自動產生的 DbCommand 物件，其為在資料來源執行更新時所需。

備註

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

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

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

產生參數名稱時的預設行為是針對各種參數使用 @p1、 @p2等等。 如果 的多載版本 GetUpdateCommand 可讓您指定此行為，您可以 DbCommandBuilder 改為根據數據行名稱產生參數。

GetUpdateCommand()

來源:

DBCommandBuilder.cs

取得在資料來源上執行更新時所需之自動產生的 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

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

備註

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

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

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

另請參閱

• 使用 CommandBuilder 產生命令
• ADO.NET 概觀 \(部分機器翻譯\)

GetUpdateCommand(Boolean)

來源:

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.DbCommand

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As DbCommand

參數

useColumnsForParameterNames

Boolean

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

傳回

DbCommand

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

備註

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

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

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

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

• ParameterNameMaxLength已指定 ，且其長度等於或大於產生的參數名稱。

• 產生的參數名稱符合正則表達式中指定的 ParameterNamePattern 準則。

• 已指定 。ParameterMarkerFormat

另請參閱

• 使用 CommandBuilder 產生命令
• ADO.NET 概觀 \(部分機器翻譯\)