Share via


DbCommandBuilder.GetInsertCommand 方法

定義

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

多載

GetInsertCommand()

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

GetInsertCommand(Boolean)

選擇性地使用參數名稱的資料行,取得自動產生的 DbCommand 物件,其為在資料來源執行插入時所需。

備註

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

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

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

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

GetInsertCommand()

來源:
DBCommandBuilder.cs
來源:
DBCommandBuilder.cs
來源:
DBCommandBuilder.cs

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

public:
 System::Data::Common::DbCommand ^ GetInsertCommand();
public System.Data.Common.DbCommand GetInsertCommand ();
member this.GetInsertCommand : unit -> System.Data.Common.DbCommand
Public Function GetInsertCommand () As DbCommand

傳回

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

備註

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

您也可以使用 GetInsertCommand 作為修改命令的基礎。 例如,您可以呼叫 GetInsertCommand 並修改命令文字,然後在 上 DbDataAdapter明確設定。

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

另請參閱

適用於

GetInsertCommand(Boolean)

來源:
DBCommandBuilder.cs
來源:
DBCommandBuilder.cs
來源:
DBCommandBuilder.cs

選擇性地使用參數名稱的資料行,取得自動產生的 DbCommand 物件,其為在資料來源執行插入時所需。

public:
 System::Data::Common::DbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);
public System.Data.Common.DbCommand GetInsertCommand (bool useColumnsForParameterNames);
member this.GetInsertCommand : bool -> System.Data.Common.DbCommand
Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As DbCommand

參數

useColumnsForParameterNames
Boolean

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

傳回

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

備註

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

您也可以使用 GetInsertCommand 作為修改命令的基礎。 例如,您可以呼叫 GetInsertCommand 並修改命令文字,然後在 上 DbDataAdapter明確設定。

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

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

另請參閱

適用於