SqlCommandBuilder.GetUpdateCommand メソッド

  • リファレンス

定義

名前空間:
System.Data.SqlClient
アセンブリ:
System.Data.SqlClient.dll
アセンブリ:
System.Data.dll
パッケージ:
System.Data.SqlClient v4.8.6

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

オーバーロード

GetUpdateCommand()

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

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

注釈

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

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

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

詳細については、「CommandBuilder でのコマンドの生成」を参照してください。

GetUpdateCommand()

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

public:
 System::Data::SqlClient::SqlCommand ^ GetUpdateCommand();
public System.Data.SqlClient.SqlCommand GetUpdateCommand ();
override this.GetUpdateCommand : unit -> System.Data.SqlClient.SqlCommand
member this.GetUpdateCommand : unit -> System.Data.SqlClient.SqlCommand
Public Function GetUpdateCommand () As SqlCommand

戻り値

SqlCommand

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

注釈

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

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

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

詳細については、「CommandBuilder でのコマンドの生成」を参照してください。

こちらもご覧ください

適用対象

GetUpdateCommand(Boolean)

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

public:
 System::Data::SqlClient::SqlCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);
public System.Data.SqlClient.SqlCommand GetUpdateCommand (bool useColumnsForParameterNames);
override this.GetUpdateCommand : bool -> System.Data.SqlClient.SqlCommand
Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommand

パラメーター

useColumnsForParameterNames
Boolean

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

戻り値

SqlCommand

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

注釈

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

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

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

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

  • ParameterNameMaxLengthGetSchema メソッドの呼び出しから返され、コレクション内でDataSourceInformation見つかった が指定されており、その長さが生成されたパラメーター名以上です。

  • 生成されたパラメーター名は、GetSchema メソッド呼び出しから返され、コレクションの正規表現で見つかった で指定されたParameterNamePattern条件をDataSourceInformation満たしています。

  • ParameterMarkerFormatGetSchema メソッドの呼び出しから返され、コレクション内で見つかった がDataSourceInformation指定されています。

詳細については、「CommandBuilder でのコマンドの生成」を参照してください。

こちらもご覧ください

適用対象