OleDbCommandBuilder.GetInsertCommand 方法

定義

命名空間:

System.Data.OleDb

組件:

System.Data.OleDb.dll

套件:

System.Data.OleDb v8.0.0

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

多載

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

備註

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

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

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

GetInsertCommand()

來源:

OleDbCommandBuilder.cs

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

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand();

public System.Data.OleDb.OleDbCommand GetInsertCommand ();

override this.GetInsertCommand : unit -> System.Data.OleDb.OleDbCommand

Public Function GetInsertCommand () As OleDbCommand

傳回

OleDbCommand

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

備註

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

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

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

另請參閱

• 使用 CommandBuilder 產生命令

GetInsertCommand(Boolean)

來源:

OleDbCommandBuilder.cs

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

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.OleDb.OleDbCommand GetInsertCommand (bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.OleDb.OleDbCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As OleDbCommand

參數

useColumnsForParameterNames

Boolean

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

傳回

OleDbCommand

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

備註

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

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

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

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

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

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

• 已指定 。ParameterMarkerFormat

另請參閱

• 使用 CommandBuilder 產生命令