DbCommandBuilder.GetInsertCommand メソッド

定義

名前空間:

System.Data.Common

アセンブリ:

System.Data.Common.dll

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

オーバーロード

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

注釈

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

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

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

パラメーター名を生成するときの既定の動作では、さまざまなパラメーターに 対して 、@p2、 などを使用@p1します。 のオーバーロードされたバージョン GetInsertCommand でこの動作を指定できる場合は、 が列名に基づいてパラメーターを生成する代わりに発生する可能性 DbCommandBuilder があります。

GetInsertCommand()

ソース:

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

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

注釈

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

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

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

こちらもご覧ください

• CommandBuilder でのコマンドの生成
• ADO.NET の概要

GetInsertCommand(Boolean)

ソース:

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

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

注釈

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

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

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

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

• が ParameterNameMaxLength 指定されており、その長さが生成されたパラメーター名以上です。

• 生成されたパラメーター名は、正規表現で指定された条件を ParameterNamePattern 満たしています。

• ParameterMarkerFormatが指定されています。

こちらもご覧ください

• CommandBuilder でのコマンドの生成
• ADO.NET の概要