About Record Sets - MACROMEDIA FLASH REMOTING MX-USING FLASH REMOTING FOR FLASH MX 2004 ACTIONSCRIPT 2.0 Use Manual

About record sets

A record set is a two-dimensional data table. The rows of the table correspond to individual data
records, such as the data for a particular product or employee. The columns of the table
correspond to different fields of a record, such as an employee's title or a product color. The
following table shows a sample record set structure:
lastName
Smith
Basham
Card
Randolph
Sykes
A RecordSet object represents a record set in Flash and contains the following elements:
•
An array of records
•
The names of the columns
•
A reference to the application server, if the record set is pageable
Note: For information on pageable record sets, see
in ColdFusion MX" on page
Typically, service functions return RecordSet objects to your Flash application. However, you can
also use ActionScript RecordSet methods to create and manage record sets directly in
ActionScript. The ability to create a RecordSet object enables you to create custom client-side
data structures for use in Flash UI Components. For more information on using
methods, see "RecordSet methods" on page
You access record set rows using the row index, much like in an array. Record indexes are relative.
The first record is at index 0, the second record is at index 1, and so on. If you insert a record into
a record set, all the indexes of all records in the RecordSet object starting with the index at which
you insert the new record get incremented by one.
RecordSet object records also have unique IDs that are never changed. If you insert a record in a
RecordSet object, it gets a new unique ID and all other record IDs are unchanged. If you delete a
record, its ID is deleted and is not reused. Flash Remoting uses this ID internally, and you cannot
use it to access a record, but you can use the
ID for any record.
Note: You cannot send RecordSet objects to the application server.
74 Chapter 4: Using Flash Remoting Data in ActionScript
firstName emailAddress
Dave dave.tomlin@macromedia.com
Meredith meredith.neville@macromedia.com
Sean sean.carr@macromedia.com
Themis themis.cripps@macromedia.com
Andrew andrew.gruber@macromedia.com
81.
"Delivering RecordSet data to Flash applications
75.
RecordSet.getItemID()
telExt
3456
7890
1234
5678
9012
RecordSet
method to determine the