DbCommandBuilder.GetInsertCommand 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得自動產生 DbCommand 的物件,用於在資料來源執行插入。
多載
| 名稱 | Description |
|---|---|
| GetInsertCommand() |
取得自動產生 DbCommand 的物件,用於在資料來源執行插入。 |
| GetInsertCommand(Boolean) |
取得自動產生 DbCommand 的物件,用於在資料來源執行插入,並可選擇使用欄位作為參數名稱。 |
備註
應用程式可將此 GetInsertCommand 方法用於資訊或故障排除,因為它回傳待執行物件的 DbCommand 文字。
你也可以用它 GetInsertCommand 作為修改指令的基礎。 例如,你可以呼叫 GetInsertCommand 並修改指令文字,然後明確設定在 DbDataAdapter.
SQL 陳述式首次產生後,應用程式必須明確呼叫 RefreshSchema 若有變更該陳述句。 否則,他們 GetInsertCommand 仍會使用前述陳述的資訊,這可能不正確。 SQL 語句首先會在應用程式呼叫Update時產生。GetInsertCommand
預設行為在產生參數名稱時,會使用 @p1、 @p2、 等來表示各種參數。 如果 的 GetInsertCommand 超載版本允許你指定這個行為,你可以讓它 DbCommandBuilder 根據欄位名稱產生參數。
GetInsertCommand()
取得自動產生 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 仍會使用前述陳述的資訊,這可能不正確。 SQL 語句首先會在應用程式呼叫Update時產生。GetInsertCommand
另請參閱
適用於
GetInsertCommand(Boolean)
取得自動產生 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 仍會使用前述陳述的資訊,這可能不正確。 SQL 語句首先會在應用程式呼叫Update時產生。GetInsertCommand
預設行為在產生參數名稱時,會使用 @p1、 @p2、 等來表示各種參數。 通過 true 參數 useColumnsForParameterNames 後,你可以強制 它 DbCommandBuilder 根據欄位名稱產生參數。 根據欄位名稱產生參數僅在滿足以下條件時成功:
已指定 , ParameterNameMaxLength 其長度等於或大於產生的參數名稱。
產生的參數名稱符合正則表達式 ParameterNamePattern 中指定的條件。
ParameterMarkerFormat A被指定。