RecordSet.removeItemAt

Availability

Flash Player�6.

Usage

RecordSet.removeItemAt(index)

Parameters

Parameter

Description

index
The index number of the record.

Parameter	Description
index	The index number of the record.

Return value

Nothing.

Description

Method. Removes the specified record. The associated record ID is never used again in the RecordSet object. When you use the removeItemAt method, avoid the following conditions:

Index out of range.
The RecordSet object is associated with an application server and not fully populated yet.

Error handling

Error condition

What happens

Error message

The RecordSet object is server-associated but not fully populated.
No change is made to the RecordSet object, and an error message is reported to the Flash MX output window and Debug Console.
Operation not allowed on partial RecordSet objects.

Index out of range
The RecordSet object is not changed.

Error condition	What happens	Error message
The `RecordSet` object is server-associated but not fully populated.	No change is made to the `RecordSet` object, and an error message is reported to the Flash MX output window and Debug Console.	Operation not allowed on partial `RecordSet` objects.
Index out of range	The `RecordSet` object is not changed.

Example

The following example demonstrates the removeItemAt method:

#include "NetServices.as"

var productList =new RecordSet(["ProductName","Price","Color"]);
var itemToAdd = {ProductName:"magicbubbles",Price:1,Color:"0x987654"};
productList.addItem(itemToAdd);
productList.removeItemAt(0);

Using Flash Remoting MX
Flash Remoting ActionScript Dictionary