共用方式為


SqlCommandBuilder.GetInsertCommand 方法

定義

多載

GetInsertCommand()

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

GetInsertCommand(Boolean)

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

GetInsertCommand()

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

public:
 Microsoft::Data::SqlClient::SqlCommand ^ GetInsertCommand();
public Microsoft.Data.SqlClient.SqlCommand GetInsertCommand ();
member this.GetInsertCommand : unit -> Microsoft.Data.SqlClient.SqlCommand
override this.GetInsertCommand : unit -> Microsoft.Data.SqlClient.SqlCommand
Public Function GetInsertCommand () As SqlCommand

傳回

執行插入所需而自動產生的 SqlCommand 物件。

備註

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

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

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

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

適用於

GetInsertCommand(Boolean)

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

public:
 Microsoft::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);
public Microsoft.Data.SqlClient.SqlCommand GetInsertCommand (bool useColumnsForParameterNames);
member this.GetInsertCommand : bool -> Microsoft.Data.SqlClient.SqlCommand
override this.GetInsertCommand : bool -> Microsoft.Data.SqlClient.SqlCommand
Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

參數

useColumnsForParameterNames
Boolean

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

傳回

執行插入時所需之自動產生的 SqlCommand 物件。

備註

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

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

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

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

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

適用於