DbCommandBuilder.GetUpdateCommand メソッド

定義

名前空間:

System.Data.Common

アセンブリ:

System.Data.Common.dll

データ ソースで更新処理を実行するための、自動生成された DbCommand オブジェクトを取得します。

オーバーロード

GetUpdateCommand()	データ ソースで更新処理を実行するための、自動生成された DbCommand オブジェクトを取得します。
GetUpdateCommand(Boolean)	オプションでパラメーター名に列を使用し、データ ソースで更新処理を実行するための、自動生成された DbCommand オブジェクトを取得します。

注釈

アプリケーションは、実行するオブジェクトを GetUpdateCommand 返 DbCommand すので、情報またはトラブルシューティングの目的で メソッドを使用できます。

変更されたコマンドの基礎として を使用 GetUpdateCommand することもできます。 たとえば、コマンド テキストを呼び出 GetUpdateCommand して変更し、 で DbDataAdapter明示的に設定できます。

SQL ステートメントが最初に生成された後、何らかの方法でステートメントが変更された場合、アプリケーションは明示的に を呼び出す RefreshSchema 必要があります。 それ以外の GetUpdateCommand 場合、 は前のステートメントの情報を引き続き使用します。これは正しくない可能性があります。 SQL ステートメントは、アプリケーションが または GetUpdateCommandを呼び出Updateすときに最初に生成されます。

パラメーター名を生成するときの既定の動作は、さまざまなパラメーターに 対して 、@p2、 などを使用@p1することです。 のオーバーロードされたバージョン GetUpdateCommand でこの動作を指定できる場合は、 を使用 DbCommandBuilder して列名に基づいてパラメーターを生成できます。

GetUpdateCommand()

ソース:

DBCommandBuilder.cs

データ ソースで更新処理を実行するための、自動生成された DbCommand オブジェクトを取得します。

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 オブジェクト。

注釈

アプリケーションは、実行するオブジェクトを GetUpdateCommand 返 DbCommand すので、情報またはトラブルシューティングの目的で メソッドを使用できます。

変更されたコマンドの基礎として を使用 GetUpdateCommand することもできます。 たとえば、コマンド テキストを呼び出 GetUpdateCommand して変更し、 で DbDataAdapter明示的に設定できます。

SQL ステートメントが最初に生成された後、何らかの方法でステートメントが変更された場合、アプリケーションは明示的に を呼び出す RefreshSchema 必要があります。 それ以外の GetUpdateCommand 場合、 は前のステートメントの情報を引き続き使用します。これは正しくない可能性があります。 SQL ステートメントは、アプリケーションが または GetUpdateCommandを呼び出Updateすときに最初に生成されます。

こちらもご覧ください

• CommandBuilder でのコマンドの生成
• ADO.NET の概要

GetUpdateCommand(Boolean)

ソース:

DBCommandBuilder.cs

オプションでパラメーター名に列を使用し、データ ソースで更新処理を実行するための、自動生成された DbCommand オブジェクトを取得します。

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

可能であれば、列名に一致するパラメーター名を生成する場合は true。 false の場合、@p1、@p2 のように生成します。

戻り値

DbCommand

更新を実行するための自動生成された DbCommand オブジェクト。

注釈

アプリケーションは、実行するオブジェクトを GetUpdateCommand 返 DbCommand すので、情報またはトラブルシューティングの目的で メソッドを使用できます。

変更されたコマンドの基礎として を使用 GetUpdateCommand することもできます。 たとえば、コマンド テキストを呼び出 GetUpdateCommand して変更し、 に明示的に DbDataAdapter設定できます。

SQL ステートメントが最初に生成された後、何らかの方法でステートメントが変更された場合、アプリケーションは明示的に を呼び出す RefreshSchema 必要があります。 それ以外の GetUpdateCommand 場合、 は前のステートメントの情報を引き続き使用します。これは正しくない可能性があります。 SQL ステートメントは、アプリケーションが または GetUpdateCommandを呼び出Updateすときに最初に生成されます。

パラメーター名を生成するときの既定の動作は、さまざまなパラメーターに 対して 、@p2、 などを使用@p1することです。 パラメーターをuseColumnsForParameterNames渡すとtrue、 を強制的DbCommandBuilderに列名に基づいて生成できます。 列名に基づくパラメーターの生成は、次の条件が満たされた場合にのみ成功します。

• ParameterNameMaxLengthが指定されており、その長さが生成されたパラメーター名以上です。

• 生成されたパラメーター名は、正規表現で指定された条件を ParameterNamePattern 満たしています。

• が ParameterMarkerFormat 指定されています。

こちらもご覧ください

• CommandBuilder でのコマンドの生成
• ADO.NET の概要