SubmitChanges メソッド (RDS)

ローカルにキャッシュされた更新可能な Recordset の保留中の変更を、Connect プロパティまたは URL プロパティに指定されたデータ ソースに送信します。

構文

DataControl.SubmitChanges

DataFactory.SubmitChanges Connection, Recordset

パラメータ

DataControl   RDS.DataControl オブジェクトを表すオブジェクト変数を指定します。

DataFactory   RDSServer.DataFactory オブジェクトを表すオブジェクト変数を指定します。

Connection   RDS.DataControl オブジェクトの Connect プロパティで作成された接続を表す文字列型 (String) の値を指定します。

Recordset   Recordset オブジェクトを表すオブジェクト変数を指定します。

解説

RDS.DataControl オブジェクトで SubmitChanges メソッドを使用する前に、Connect、Server、および SQL の各プロパティが設定されている必要があります。

同じ Recordset オブジェクトで、SubmitChanges メソッドを呼び出した後に CancelUpdate メソッドを呼び出すと、変更は既にコミットされているので、CancelUpdate メソッドの呼び出しは失敗します。

変更されたレコードのみが送信され修正されます。この時、変更処理がすべて成功するか、またはすべて失敗するかのどちらかになります。

既定の RDSServer.DataFactory オブジェクトでのみ SubmitChanges メソッドを使用できます。カスタム ビジネス オブジェクトでは、このメソッドを使用できません。

URL プロパティが設定されている場合、SubmitChanges メソッドは、URL で指定された場所に変更を送信します。