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.

注釈

アプリケーションでは、実行する DbCommand オブジェクトのテキストを返すため、情報やトラブルシューティングのために GetInsertCommand メソッドを使用できます。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 オブジェクト。The automatically generated DbCommand object required to perform insertions.

注釈

アプリケーションでは、実行する DbCommand オブジェクトのテキストを返すため、情報やトラブルシューティングのために GetInsertCommand メソッドを使用できます。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 オブジェクト。The automatically generated DbCommand object required to perform insertions.

注釈

アプリケーションでは、実行する DbCommand オブジェクトのテキストを返すため、情報やトラブルシューティングのために GetInsertCommand メソッドを使用できます。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. useColumnsForParameterNames パラメーターに true を渡すと、代わりに列名に基づいてパラメーターを生成するように 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:

こちらもご覧ください

適用対象