onLoad = function(success:Boolean) {}

XML ドキュメントをサーバーから受信すると、Flash Player によって呼び出されます。XML ドキュメントが正常に受信された場合、success パラメータは true です。ファイルが受信されなかったか、サーバーから応答を受信する際にエラーが発生した場合は、success パラメータには false が渡されます。デフォルトでは、このメソッドの実行形態は非アクティブになります。デフォルトの実行形態を無効にするには、カスタムアクションを含む関数を割り当てます。

パラメータ

success:Boolean - ブール値。XML.load() または XML.sendAndLoad() を使用して XML オブジェクトが正常にロードされた場合は true、それ以外の場合は false です。

例

次の例には、簡単な電子商取引店頭アプリケーション用の ActionScript が含まれています。sendAndLoad() メソッドは、ユーザーの名前とパスワードを含む XML エレメントを転送し、XML.onLoad ハンドラを使用してサーバーからの応答を処理します。

var login_str:String = "<login username=¥""+username_txt.text+"¥" password=¥""+password_txt.text+"¥" />";
var my_xml:XML = new XML(login_str);
var myLoginReply_xml:XML = new XML();

myLoginReply_xml.ignoreWhite = true;

myLoginReply_xml.onLoad = function(success:Boolean){

    if (success) {

        if ((myLoginReply_xml.firstChild.nodeName == "packet") &&
            (myLoginReply_xml.firstChild.attributes.success == "true")) {
            gotoAndStop("loggedIn");
        } else {
            gotoAndStop("loginFailed");
        }

    } else {
        gotoAndStop("connectionFailed");
    }

};

my_xml.sendAndLoad("http://www.flash-mx.com/mm/login_xml.cfm", myLoginReply_xml);

関連項目

load (XML.load メソッド), sendAndLoad (XML.sendAndLoad メソッド)