Flash CS3 Documentation

ActionScript 2.0 Components Language Reference > DataSet component > DataSet.setIterator()

DataSet.setIterator()

Availability

Flash Player 7.

Edition

Flash MX Professional 2004.

Usage

dataSetInstance.setIterator(iterator)

Parameters

iterator An iterator object returned by a call to DataSet.getIterator().

Returns

Nothing.

Description

Method; assigns the specified iterator to this DataSet object and makes it the current iterator. The specified iterator must come from a previous call to DataSet.getIterator() on the DataSet object to which it is being assigned; otherwise; a DataSetError exception is thrown.

Example

import mx.data.to.ValueListIterator;
myIterator:ValueListIterator = my_ds.getIterator();
myIterator.sortOn(["name"]);
my_ds.setIterator(myIterator);