User Guide

LoadVars.onData 323
LoadVars.onData
Availability
Flash Player 6.
Usage
my_lv.onData = function(src:String) {
// your statements here
}
Parameters
src
A string or undefined; the raw (unparsed) data from a LoadVars.load() or
LoadVars.sendAndLoad() method call.
Returns
Nothing.
Description
Event handler; 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.
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 writes to the log
file.
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");