DbCommandBuilder.GetUpdateCommand メソッド

定義

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

オーバーロード

GetUpdateCommand()

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

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()

データ ソースで更新処理を実行するための、自動生成された 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

更新を実行するための自動生成された 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)

オプションでパラメーター名に列を使用し、データ ソースで更新処理を実行するための、自動生成された 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

可能であれば、列名に一致するパラメーター名を生成する場合は 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 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パラメーターにを渡す 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:

適用対象