OleDbCommandBuilder.GetUpdateCommand メソッド

public:
 System::Data::OleDb::OleDbCommand ^ GetUpdateCommand();

public System.Data.OleDb.OleDbCommand GetUpdateCommand();

member this.GetUpdateCommand : unit -> System.Data.OleDb.OleDbCommand

override this.GetUpdateCommand : unit -> System.Data.OleDb.OleDbCommand

Public Function GetUpdateCommand () As OleDbCommand

返品

自動的に生成された OleDbCommand オブジェクトは、更新を実行するために必要です。

注釈

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

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

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

こちらもご覧ください

• CommandBuilders を使用したコマンドの生成

public:
 System::Data::OleDb::OleDbCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);

public System.Data.OleDb.OleDbCommand GetUpdateCommand(bool useColumnsForParameterNames);

override this.GetUpdateCommand : bool -> System.Data.OleDb.OleDbCommand

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As OleDbCommand

パラメーター

返品

自動的に生成された OleDbCommand オブジェクトは、更新を実行するために必要です。

注釈

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

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

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

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

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

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

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

こちらもご覧ください

• CommandBuilders を使用したコマンドの生成