onData = function(src:String) {}

サーバーからの XML テキストのダウンロードが完了するか、サーバーからの XML テキストのダウンロード中にエラーが発生すると呼び出されます。このハンドラは XML の解析前に呼び出されるため、このハンドラを使用して、Flash XML パーサーを使用する代わりにカスタム解析ルーチンを呼び出すことができます。src パラメータは、ダウンロード中にエラーが発生しなければ、サーバーからダウンロードされた XML テキストを含むストリングになります。エラーが発生した場合、src パラメータは undefined になります。

デフォルトでは、XML.onData イベントハンドラは XML.onLoad を呼び出します。XML.onData イベントハンドラを無効にしてカスタムビヘイビアを使用することができます。ただし、その場合、自分で実装する XML.onData で呼び出さない限り、XML.onLoad は呼び出されません。

パラメータ

src:String - ストリングまたは undefined。サーバーから送られる生の (通常は XML 形式の) データです。

例

次の例では、XML.onData イベントハンドラのデフォルトの動作を示します。

XML.prototype.onData = function (src:String) {
    if (src == undefined) {
        this.onLoad(false);
    } else {
        this.parseXML(src);
        this.loaded = true;
        this.onLoad(true);
    }
}

XML.onData イベントハンドラをオーバーライド (上書き定義) して、XML テキストを解析せずに取得することができます。

関連項目

onLoad (XML.onLoad ハンドラ)