User Guide

400 ActionScript classes

onData (LoadVars.onData handler)

onData = function(src:String) {}

Invoked when data has completely downloaded from the server or when an error occurs while

data is downloading from a server. This handler is invoked before the data is parsed and can

be used to call a custom parsing routine instead of the one built in to Flash Player. The value

of the

src parameter passed to the function assigned to LoadVars.onData can be either

undefined or a string that contains the URL-encoded name-value pairs downloaded from the

server. If the

src parameter is undefined, an error occurred while downloading the data from

the server.

The default implementation of

LoadVars.onData invokes LoadVars.onLoad. You can

override this default implementation by assigning a custom function to

LoadVars.onData,

but

LoadVars.onLoad is not called unless you call it in your implementation of

LoadVars.onData.

Availability: ActionScript 1.0; Flash Lite 2.0

Parameters

src:String - A string or undefined; the raw (unparsed) data from a LoadVars.load() or

LoadVars.sendAndLoad() method call.

Example

The following example loads a text file and displays content in a TextArea instance called

content_ta when the operation completes. If an error occurs, then information displays in

the Output panel.

var my_lv:LoadVars = new LoadVars();

my_lv.onData = function(src:String) {

if (src == undefined) {

trace("Error loading content.");

return;

}

content_ta.text = src;

};

my_lv.load("content.txt", my_lv, "GET");