RDS 2.5 API Reference

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.

See Also

VBScript Example

Address Book Command Buttons | CancelUpdate Method (RDS) | Refresh Method (RDS)

Applies To: DataControl Object (RDS) | DataFactory Object (RDSServer)

© 1998-2003 Microsoft Corporation. All rights reserved.