次の方法で共有


SqlCommandBuilder.GetInsertCommand メソッド

定義

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

オーバーロード

GetInsertCommand()

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

GetInsertCommand(Boolean)

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

注釈

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

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

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

詳細については、「CommandBuilder でのコマンドの生成」を参照してください。

GetInsertCommand()

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

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand();
public System.Data.SqlClient.SqlCommand GetInsertCommand ();
member this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand
override this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand
Public Function GetInsertCommand () As SqlCommand

戻り値

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

注釈

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

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

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

詳細については、「CommandBuilder でのコマンドの生成」を参照してください。

こちらもご覧ください

適用対象

GetInsertCommand(Boolean)

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

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);
public System.Data.SqlClient.SqlCommand GetInsertCommand (bool useColumnsForParameterNames);
override this.GetInsertCommand : bool -> System.Data.SqlClient.SqlCommand
Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

パラメーター

useColumnsForParameterNames
Boolean

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

戻り値

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

注釈

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

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

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

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

  • ParameterNameMaxLength GetSchema メソッド呼び出しから返され、コレクション内でDataSourceInformation見つかった が指定されており、その長さが生成されたパラメーター名以上です。

  • 生成されたパラメーター名は、GetSchema メソッド呼び出しから返され、コレクションの正規表現で見つかった で指定されたParameterNamePattern条件をDataSourceInformation満たしています。

  • ParameterMarkerFormat GetSchema メソッド呼び出しから返され、コレクション内で見つかった がDataSourceInformation指定されています。

詳細については、「CommandBuilder でのコマンドの生成」を参照してください。

こちらもご覧ください

適用対象