User Guide

384 Components Dictionary
DataSet.locateById()
Availability
Flash Player 7.
Edition
Flash MX Professional 2004.
Usage
dataSetInstance.locateById(id)
Parameters
id A string identifier for the item in the collection to be located.
Returns
A Boolean value.
Description
Method; positions the current iterator on the collection item whose ID matches id. This
method returns
true if the specified ID can be matched to an item in the collection;
otherwise, it returns
false.
Example
The following example uses DataSet.find() to search for an item in the current collection
whose
name and id fields contain the values "Bobby" and 105, respectively. If found,
DataSet.getItemId() is used to get the unique identifier for that item, and
DataSet.locateById() is used to position the current iterator at that item.