SqlCommandBuilder.GetInsertCommand メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データベースで挿入処理を実行するための、自動生成された SqlCommand オブジェクトを取得します。
オーバーロード
| GetInsertCommand() |
データベースで挿入処理を実行するための、自動生成された SqlCommand オブジェクトを取得します。 |
| GetInsertCommand(Boolean) |
データベースで挿入処理を実行するための、自動生成された SqlCommand オブジェクトを取得します。 |
注釈
アプリケーションは、実行するオブジェクトを GetInsertCommand 返 SqlCommand すので、情報またはトラブルシューティングの目的で メソッドを使用できます。
変更されたコマンドの基礎として を使用 GetInsertCommand することもできます。 たとえば、 を呼び出 GetInsertCommand して値を CommandTimeout 変更し、それを に明示的に SqlDataAdapter設定できます。
Transact-SQL ステートメントが最初に生成された後、何らかの方法でステートメントが変更された場合、アプリケーションは明示的に を呼び出す RefreshSchema 必要があります。 それ以外の GetInsertCommand 場合、 は前のステートメントの情報を引き続き使用します。これは正しくない可能性があります。 Transact-SQL ステートメントは、アプリケーションが または GetInsertCommandをUpdate呼び出すときに最初に生成されます。
詳細については、「CommandBuilder でのコマンドの生成」を参照してください。
GetInsertCommand()
データベースで挿入処理を実行するための、自動生成された SqlCommand オブジェクトを取得します。
public:
System::Data::SqlClient::SqlCommand ^ GetInsertCommand();public System.Data.SqlClient.SqlCommand GetInsertCommand ();override this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommandmember this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommandPublic Function GetInsertCommand () As SqlCommand戻り値
挿入を実行するための自動生成された SqlCommand オブジェクト。
注釈
アプリケーションは、実行するオブジェクトを GetInsertCommand 返 SqlCommand すので、情報またはトラブルシューティングの目的で メソッドを使用できます。
変更されたコマンドの基礎として を使用 GetInsertCommand することもできます。 たとえば、 を呼び出 GetInsertCommand して値を CommandTimeout 変更し、それを に明示的に SqlDataAdapter設定できます。
Transact-SQL ステートメントが最初に生成された後、何らかの方法でステートメントが変更された場合、アプリケーションは明示的に を呼び出す RefreshSchema 必要があります。 それ以外の GetInsertCommand 場合、 は前のステートメントの情報を引き続き使用します。これは正しくない可能性があります。 Transact-SQL ステートメントは、アプリケーションが または GetInsertCommandをUpdate呼び出すときに最初に生成されます。
詳細については、「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.SqlCommandPublic Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommandパラメーター
- useColumnsForParameterNames
- Boolean
可能であれば、列名に一致するパラメーター名を生成する場合は true。
false の場合、@p1、@p2 のように生成します。
戻り値
挿入を実行するための自動生成された SqlCommand オブジェクト。
注釈
アプリケーションは、実行するオブジェクトを GetInsertCommand 返 SqlCommand すので、情報またはトラブルシューティングの目的で メソッドを使用できます。
変更されたコマンドの基礎として を使用 GetInsertCommand することもできます。 たとえば、 を呼び出 GetInsertCommand して値を CommandTimeout 変更し、それを に明示的に SqlDataAdapter設定できます。
Transact-SQL ステートメントが最初に生成された後、何らかの方法でステートメントが変更された場合、アプリケーションは明示的に を呼び出す RefreshSchema 必要があります。 それ以外の GetInsertCommand 場合、 は前のステートメントの情報を引き続き使用します。これは正しくない可能性があります。 Transact-SQL ステートメントは、アプリケーションが または GetInsertCommandをUpdate呼び出すときに最初に生成されます。
パラメーター名を生成するときの既定の動作は、さまざまなパラメーターに 対して 、@p2、 などを使用@p1することです。 パラメーターをuseColumnsForParameterNames渡trueすと、 を強制OleDbCommandBuilderして列名に基づいてパラメーターを生成できます。 これは、次の条件が満たされた場合にのみ成功します。
ParameterNameMaxLength GetSchema メソッド呼び出しから返され、コレクション内でDataSourceInformation見つかった が指定されており、その長さが生成されたパラメーター名以上です。
生成されたパラメーター名は、GetSchema メソッド呼び出しから返され、コレクションの正規表現で見つかった で指定されたParameterNamePattern条件をDataSourceInformation満たしています。
ParameterMarkerFormat GetSchema メソッド呼び出しから返され、コレクション内で見つかった がDataSourceInformation指定されています。
詳細については、「CommandBuilder でのコマンドの生成」を参照してください。
こちらもご覧ください
適用対象
.NET