次の方法で共有


DbCommandBuilder.GetInsertCommand メソッド

定義

データ ソースで挿入処理を実行するための、自動生成された DbCommand オブジェクトを取得します。

オーバーロード

GetInsertCommand()

データ ソースで挿入処理を実行するための、自動生成された DbCommand オブジェクトを取得します。

GetInsertCommand(Boolean)

オプションでパラメーター名に列を使用し、データ ソースで挿入処理を実行するための、自動生成された DbCommand オブジェクトを取得します。

注釈

アプリケーションは、実行するオブジェクトの GetInsertCommand テキストを返すので、情報またはトラブルシューティングの目的で メソッドを DbCommand 使用できます。

変更されたコマンドの基礎として を使用 GetInsertCommand することもできます。 たとえば、コマンド テキストを呼び出 GetInsertCommand して変更し、 に明示的に DbDataAdapter設定します。

SQL ステートメントが最初に生成された後、何らかの方法でステートメントを変更する場合、アプリケーションは明示的に を呼び出す RefreshSchema 必要があります。 それ以外の GetInsertCommand 場合、 は前のステートメントの情報を引き続き使用します。これは正しくない可能性があります。 SQL ステートメントは、アプリケーションが または GetInsertCommandを呼び出Updateすときに最初に生成されます。

パラメーター名を生成するときの既定の動作では、さまざまなパラメーターに 対して 、@p2、 などを使用@p1します。 のオーバーロードされたバージョン 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 場合、 は前のステートメントの情報を引き続き使用します。これは正しくない可能性があります。 SQL ステートメントは、アプリケーションが または GetInsertCommandを呼び出Updateすときに最初に生成されます。

こちらもご覧ください

適用対象

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

可能であれば、列名に一致するパラメーター名を生成する場合は truefalse の場合、@p1@p2 のように生成します。

戻り値

挿入を実行するための自動生成された DbCommand オブジェクト。

注釈

アプリケーションは、実行するオブジェクトの GetInsertCommand テキストを返すので、情報またはトラブルシューティングの目的で メソッドを DbCommand 使用できます。

変更されたコマンドの基礎として を使用 GetInsertCommand することもできます。 たとえば、コマンド テキストを呼び出 GetInsertCommand して変更し、 に明示的に DbDataAdapter設定します。

SQL ステートメントが最初に生成された後、何らかの方法でステートメントを変更する場合、アプリケーションは明示的に を呼び出す RefreshSchema 必要があります。 それ以外の GetInsertCommand 場合、 は前のステートメントの情報を引き続き使用します。これは正しくない可能性があります。 SQL ステートメントは、アプリケーションが または GetInsertCommandを呼び出Updateすときに最初に生成されます。

パラメーター名を生成するときの既定の動作では、さまざまなパラメーターに 対して 、@p2、 などを使用@p1します。 パラメーターをuseColumnsForParameterNames渡すとtrue、 を強制的DbCommandBuilderに列名に基づいて生成できます。 列名に基づくパラメーターの生成は、次の条件が満たされた場合にのみ成功します。

こちらもご覧ください

適用対象