DbCommandBuilder.GetUpdateCommand DbCommandBuilder.GetUpdateCommand DbCommandBuilder.GetUpdateCommand DbCommandBuilder.GetUpdateCommand Method

定義

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

オーバーロード

GetUpdateCommand() GetUpdateCommand() GetUpdateCommand() GetUpdateCommand()

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

GetUpdateCommand(Boolean) GetUpdateCommand(Boolean) GetUpdateCommand(Boolean) GetUpdateCommand(Boolean)

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

注釈

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

また、を変更GetUpdateCommandしたコマンドのベースとして使用することもできます。You can also use GetUpdateCommand as the basis of a modified command. たとえば、コマンドテキストを呼び出しGetUpdateCommandて変更し、 DbDataAdapterで明示的に設定することができます。For example, you might call GetUpdateCommand 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. それ以外のGetUpdateCommand場合、は、前のステートメントの情報を使用しますが、正しくない可能性があります。Otherwise, the GetUpdateCommand will still be using information from the previous statement, which might not be correct. SQL ステートメントは、アプリケーションがまたはUpdate GetUpdateCommandを呼び出すと、最初に生成されます。The SQL statements are first generated either when the application calls Update or GetUpdateCommand.

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

GetUpdateCommand() GetUpdateCommand() GetUpdateCommand() GetUpdateCommand()

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

public:
 System::Data::Common::DbCommand ^ GetUpdateCommand();
public System.Data.Common.DbCommand GetUpdateCommand ();
member this.GetUpdateCommand : unit -> System.Data.Common.DbCommand
Public Function GetUpdateCommand () As DbCommand

戻り値

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

注釈

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

また、を変更GetUpdateCommandしたコマンドのベースとして使用することもできます。You can also use GetUpdateCommand as the basis of a modified command. たとえば、コマンドテキストを呼び出しGetUpdateCommandて変更し、 DbDataAdapterで明示的に設定することができます。For example, you might call GetUpdateCommand 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. それ以外のGetUpdateCommand場合、は、前のステートメントの情報を使用しますが、正しくない可能性があります。Otherwise, the GetUpdateCommand will still be using information from the previous statement, which might not be correct. SQL ステートメントは、アプリケーションがまたはUpdate GetUpdateCommandを呼び出すと、最初に生成されます。The SQL statements are first generated either when the application calls Update or GetUpdateCommand.

こちらもご覧ください

GetUpdateCommand(Boolean) GetUpdateCommand(Boolean) GetUpdateCommand(Boolean) GetUpdateCommand(Boolean)

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

public:
 System::Data::Common::DbCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);
public System.Data.Common.DbCommand GetUpdateCommand (bool useColumnsForParameterNames);
member this.GetUpdateCommand : bool -> System.Data.Common.DbCommand
Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As DbCommand

パラメーター

useColumnsForParameterNames
Boolean Boolean Boolean 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 updates.

注釈

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

また、を変更GetUpdateCommandしたコマンドのベースとして使用することもできます。You can also use GetUpdateCommand as the basis of a modified command. たとえば、コマンドテキストを呼び出しGetUpdateCommandて変更し、 DbDataAdapterで明示的に設定することができます。For example, you might call GetUpdateCommand 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. それ以外のGetUpdateCommand場合、は、前のステートメントの情報を使用しますが、正しくない可能性があります。Otherwise, the GetUpdateCommand will still be using information from the previous statement, which might not be correct. SQL ステートメントは、アプリケーションがまたはUpdate GetUpdateCommandを呼び出すと、最初に生成されます。The SQL statements are first generated either when the application calls Update or GetUpdateCommand.

パラメーター名を生成するときの既定の動作では@p1@p2さまざまなパラメーターに対して、、などを使用します。The default behavior, when generating parameter names, is to use @p1, @p2, and so on for the various parameters. パラメーターにを渡すtrueと、ではDbCommandBuilderなく列名に基づいてパラメーターを生成するように強制できます。 useColumnsForParameterNamesPassing 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:

こちらもご覧ください

適用対象