DbCommandBuilder.GetInsertCommand メソッド

定義

データ ソースで挿入処理を実行するための、自動生成された DbCommand オブジェクトを取得します。Gets the automatically generated DbCommand object required to perform insertions at the data source.

オーバーロード

GetInsertCommand()

データ ソースで挿入処理を実行するための、自動生成された DbCommand オブジェクトを取得します。Gets the automatically generated DbCommand object required to perform insertions at the data source.

GetInsertCommand(Boolean)

オプションでパラメーター名に列を使用し、データ ソースで挿入処理を実行するための、自動生成された DbCommand オブジェクトを取得します。Gets the automatically generated DbCommand object required to perform insertions at the data source, optionally using columns for parameter names.

注釈

アプリケーションでは、 GetInsertCommand 実行するオブジェクトのテキストを返すため、情報またはトラブルシューティングの目的でメソッドを使用でき DbCommand ます。An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the text of the DbCommand object to be executed.

また、を変更した GetInsertCommand コマンドのベースとして使用することもできます。You can also use GetInsertCommand as the basis of a modified command. たとえば、 GetInsertCommand コマンドテキストを呼び出して変更し、で明示的に設定することができ DbDataAdapter ます。For example, you might call GetInsertCommand and modify command text, and then explicitly set that on the DbDataAdapter.

SQL ステートメントが最初に生成された後、アプリケーションは RefreshSchema ステートメントを何らかの方法で変更した場合は、明示的にを呼び出す必要があります。After the SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. それ以外の場合、は、 GetInsertCommand 前のステートメントの情報を使用しますが、正しくない可能性があります。Otherwise, the GetInsertCommand will still be using information from the previous statement, which might not be correct. SQL ステートメントは、アプリケーションがまたはを呼び出すと、最初に生成され Update GetInsertCommand ます。The SQL statements are first generated either when the application calls Update or GetInsertCommand.

パラメーター名を生成するときの既定の動作では @p1@p2 さまざまなパラメーターに対して、、などを使用します。The default behavior, when generating parameter names, is to use @p1, @p2, and so on for the various parameters. のオーバーロードされたバージョンで GetInsertCommand この動作を指定できる場合、では DbCommandBuilder なく列名に基づいてパラメーターが生成されるようになります。If the overloaded version of GetInsertCommand allows you to specify this behavior, you can cause the DbCommandBuilder to generate parameters based on the column names instead.

GetInsertCommand()

データ ソースで挿入処理を実行するための、自動生成された DbCommand オブジェクトを取得します。Gets the automatically generated DbCommand object required to perform insertions at the data source.

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 オブジェクト。The automatically generated DbCommand object required to perform insertions.

注釈

アプリケーションでは、 GetInsertCommand 実行するオブジェクトのテキストを返すため、情報またはトラブルシューティングの目的でメソッドを使用でき DbCommand ます。An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the text of the DbCommand object to be executed.

また、を変更した GetInsertCommand コマンドのベースとして使用することもできます。You can also use GetInsertCommand as the basis of a modified command. たとえば、 GetInsertCommand コマンドテキストを呼び出して変更し、で明示的に設定することができ DbDataAdapter ます。For example, you might call GetInsertCommand and modify the command text, and then explicitly set that on the DbDataAdapter.

SQL ステートメントが最初に生成された後、アプリケーションは RefreshSchema ステートメントを何らかの方法で変更した場合は、明示的にを呼び出す必要があります。After the SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. それ以外の場合、は、 GetInsertCommand 前のステートメントの情報を使用しますが、正しくない可能性があります。Otherwise, the GetInsertCommand will still be using information from the previous statement, which might not be correct. SQL ステートメントは、アプリケーションがまたはを呼び出すと、最初に生成され Update GetInsertCommand ます。The SQL statements are first generated either when the application calls Update or GetInsertCommand.

適用対象

GetInsertCommand(Boolean)

オプションでパラメーター名に列を使用し、データ ソースで挿入処理を実行するための、自動生成された DbCommand オブジェクトを取得します。Gets the automatically generated DbCommand object required to perform insertions at the data source, optionally using columns for parameter names.

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

可能であれば、列名に一致するパラメーター名を生成する場合は trueIf true, generate parameter names matching column names, if possible. false の場合、@p1@p2 のように生成します。If false, generate @p1, @p2, and so on.

戻り値

DbCommand

挿入を実行するための自動生成された DbCommand オブジェクト。The automatically generated DbCommand object required to perform insertions.

注釈

アプリケーションでは、 GetInsertCommand 実行するオブジェクトのテキストを返すため、情報またはトラブルシューティングの目的でメソッドを使用でき DbCommand ます。An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the text of the DbCommand object to be executed.

また、を変更した GetInsertCommand コマンドのベースとして使用することもできます。You can also use GetInsertCommand as the basis of a modified command. たとえば、 GetInsertCommand コマンドテキストを呼び出して変更し、で明示的に設定することができ DbDataAdapter ます。For example, you might call GetInsertCommand and modify the command text, and then explicitly set that on the DbDataAdapter.

SQL ステートメントが最初に生成された後、アプリケーションは RefreshSchema ステートメントを何らかの方法で変更した場合は、明示的にを呼び出す必要があります。After the SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. それ以外の場合、は、 GetInsertCommand 前のステートメントの情報を使用しますが、正しくない可能性があります。Otherwise, the GetInsertCommand will still be using information from the previous statement, which might not be correct. SQL ステートメントは、アプリケーションがまたはを呼び出すと、最初に生成され Update GetInsertCommand ます。The SQL statements are first generated either when the application calls Update or GetInsertCommand.

パラメーター名を生成するときの既定の動作では @p1@p2 さまざまなパラメーターに対して、、などを使用します。The default behavior, when generating parameter names, is to use @p1, @p2, and so on for the various parameters. trueパラメーターにを渡す useColumnsForParameterNames と、では DbCommandBuilder なく列名に基づいてパラメーターを生成するように強制できます。Passing true for the useColumnsForParameterNames parameter allows you to force the DbCommandBuilder to generate parameters based on the column names instead. 列名に基づくパラメーターの生成は、次の条件が満たされている場合にのみ成功します。Generation of the parameters based on column names succeeds only if the following conditions are met:

適用対象