SqlCommandBuilder.GetUpdateCommand 方法

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.dll

取得自動產生 SqlCommand 的物件，用於對資料庫進行更新。

新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。

多載

名稱	Description
GetUpdateCommand()	取得自動產生 SqlCommand 的物件，用於對資料庫進行更新。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。
GetUpdateCommand(Boolean)	取得自動產生 SqlCommand 的物件，用於對資料庫進行更新。 新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。

備註

應用程式可將此 GetUpdateCommand 方法用於資訊或故障排除，因為它會回傳 SqlCommand 待執行的物件。

你也可以用它 GetUpdateCommand 作為修改指令的基礎。 例如，你可以呼叫 GetUpdateCommand 並修改 該 CommandTimeout 值，然後明確設定在 SqlDataAdapter。

在 Transact-SQL 陳述句首次產生後，應用程式若以任何方式更改該陳述，必須明確呼叫 RefreshSchema。 否則，他們 GetUpdateCommand 仍會使用前述陳述的資訊，這可能不正確。 當應用程式呼叫 Update 或 GetUpdateCommand 時，Transact-SQL 語句會首先產生。

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

GetUpdateCommand()

取得自動產生 SqlCommand 的物件，用於對資料庫進行更新。

新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。

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

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

override this.GetUpdateCommand : unit -> System.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 產生命令。

另請參閱

• ADO.NET 中連接與檢索資料
• 使用 .NET Framework 資料提供者用於 SQL Server
• ADO.NET 概觀

GetUpdateCommand(Boolean)

取得自動產生 SqlCommand 的物件，用於對資料庫進行更新。

新開發的話，請使用 Microsoft。Data.SqlClient。 本頁說明了 System.Data.SqlClient。

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

參數

useColumnsForParameterNames

Boolean

若 true，則產生與欄位名稱相符的參數名稱（若可能）。 若 false，則生成 @p1， @p2依此類推。

傳回

SqlCommand

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

備註

應用程式可將此 GetUpdateCommand 方法用於資訊或故障排除，因為它會回傳 SqlCommand 待執行的物件。

你也可以用它 GetUpdateCommand 作為修改指令的基礎。 例如，你可以呼叫 GetUpdateCommand 並修改 該 CommandTimeout 值，然後明確設定在 SqlDataAdapter。

在 Transact-SQL 陳述句首次產生後，應用程式若以任何方式更改該陳述，必須明確呼叫 RefreshSchema。 否則，他們 GetUpdateCommand 仍會使用前述陳述的資訊，這可能不正確。 當應用程式呼叫 Update 或 GetUpdateCommand 時，Transact-SQL 語句會首先產生。

預設行為在產生參數名稱時，會使用 @p1、 @p2、 等來表示各種參數。 通過 true 參數 useColumnsForParameterNames 後，你可以強制 它 OleDbCommandBuilder 根據欄位名稱產生參數。 此策略僅在滿足以下條件時成功：

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

• 產生的參數名稱符合從 ParameterNamePattern 方法呼叫回傳並可在集合正規表達式中找到的條件DataSourceInformation。

• ParameterMarkerFormat從 GetSchema 方法呼叫回傳且在集合中找到DataSourceInformation的 A 被指定為

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

另請參閱

• ADO.NET 中連接與檢索資料
• 使用 .NET Framework 資料提供者用於 SQL Server
• ADO.NET 概觀