Dataset.deltapacket - MACROMEDIA FLASH 8-COMPONENTS LANGUAGE Reference

DataSet.deltaPacket

Availability
Flash Player 7.
Edition
Flash MX Professional 2004.
Usage
dataSetInstance.deltaPacket
Description
Property; returns a delta packet that contains all of the change operations made to the
collection and its items. This property is until is
dataSet null DataSet.applyUpdates()
called on .
dataSet
When is called, a transaction ID is assigned to the delta packet.
DataSet.applyUpdates()
This transaction ID is used to identify the delta packet on an update round trip from the
server and back to the client. Any subsequent assignment to the property by a
deltaPacket
delta packet with a matching transaction ID is assumed to be the server's response to the
changes previously sent. A delta packet with a matching ID is used to update the collection
and report errors specified within the packet.
Errors or server messages are reported to listeners of the event. Note
DataSet.resolveDelta
that the settings are ignored when a delta packet with a matching ID is
DataSet.logChanges
assigned to . A delta packet without a matching transaction ID
DataSet.deltaPacket
updates the collection, as if the DataSet API were used directly. This may create additional
delta entries, depending on the current setting of and the
DataSet.logChanges dataSet
delta packet.
A exception is thrown if a delta packet is assigned with a matching transaction
DataSetError
ID and one of the items in the newly assigned delta packet cannot be found in the original
delta packet.
See also
, ,
DataSet.applyUpdates() DataSet.logChanges DataSet.resolveDelta
354 Components Dictionary