DbCommandBuilder.GetInsertCommand メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ ソースで挿入を実行するために必要な、自動的に生成された DbCommand オブジェクトを取得します。
オーバーロード
| 名前 | 説明 |
|---|---|
| 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.DbCommandPublic 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.DbCommandPublic 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が指定されています。
