SubmitChanges Method (RDS)

Microsoft ActiveX Data Objects (ADO)

SubmitChanges Method (RDS)

       

Submits pending changes of the locally cached and updatable Recordset to the data source specified in the Connect property or the URL property.

Syntax

DataControl.SubmitChanges

DataFactory.SubmitChanges Connection, Recordset

Parameters

DataControl   An object variable that represents an RDS.DataControl object.

DataFactory   An object variable that represents an RDSServer.DataFactory object.

Connection   A String value that represents the connection created with the RDS.DataControl object's Connect property.

Recordset   An object variable that represents a Recordset object.

Remarks

The Connect, Server, and SQL properties must be set before you can use the SubmitChanges method with the RDS.DataControl object.

If you call the CancelUpdate method after you have called SubmitChanges for the same Recordset object, the CancelUpdate call fails because the changes have already been committed.

Only the changed records are sent for modification, and either all of the changes succeed or all of them fail together.

You can use SubmitChanges only with the default RDSServer.DataFactory object. Custom business objects can't use this method.

If the URL property has been set, SubmitChanges will submit changes to the location specified by the URL.