Flash Lite 2

Flash Lite 2.x ActionScript リファレンスガイド > ActionScript クラス > LoadVars > onData (LoadVars.onData ハンドラ)

onData (LoadVars.onData ハンドラ)

onData = function(src: String) {}

サーバーからのデータのダウンロードが完了したとき、またはサーバーからデータをダウンロード中にエラーが発生したときに呼び出されます。このハンドラはデータが解析される前に呼び出されるので、Flash Player に組み込まれている解析ルーチンではなく、独自の解析ルーチンを呼び出す場合に利用できます。LoadVars.onData に割り当てられた関数の src パラメータの値は undefined であるか、またはサーバーからダウンロードされた URL エンコード形式の名前と値のペアを含むストリングです。src パラメータが undefined である場合は、サーバーからのデータのダウンロード時にエラーが発生したことを示しています。

デフォルトの実装では、LoadVars.onData は LoadVars.onLoad を呼び出します。LoadVars.onData にカスタム関数を割り当ててデフォルトの実装を上書きすることはできますが、独自に実装した LoadVars.onData の中で呼び出さない限り、LoadVars.onLoad は呼び出されません。

使用できるバージョン : ActionScript 1.0、Flash Lite 2.0

パラメータ

src: String - ストリングまたは undefined。LoadVars.load() または LoadVars.sendAndLoad() メソッドの呼び出しから返される生 (未解析) のデータ。

例

次の例では、テキストファイルをロードし、ロード処理の完了時に内容を TextArea インスタンス content_ta に表示します。エラーが発生した場合は、その情報を [出力] パネルに表示します。

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");

onData (LoadVars.onData ハンドラ)

パラメータ

例

関連項目