onXML = function(src:XML) {}

XML ドキュメントを含む指定の XML オブジェクトが、開いている XMLSocket 接続を通して届いたときに、Flash Lite Player によって呼び出されます。XMLSocket 接続を使用してクライアントとサーバーの間で転送できる XML ドキュメントの数に制限はありません。各ドキュメントは、値ゼロ (0) のバイトで終了します。Flash Lite Player がゼロバイトを受信すると、直前のゼロバイト以降に受信されたか、またはこれが最初に受信されたメッセージである場合は接続が確立された後に受信された、すべての XML を解析します。解析された XML の集合は 1 つの XML ドキュメントとして処理され、onXML() メソッドに渡されます。

このメソッドのデフォルトの実行形態では、アクションを実行しません。デフォルトの実行形態を無効にするには、独自に定義したアクションを含む関数を割り当てます。

パラメータ

src:XML - サーバーから受信した解析済み XML ドキュメントを含む XML オブジェクト。

例

次の例では、簡単なチャットアプリケーションで onXML() メソッドのデフォルトの実装を無効にします。関数 myOnXML() は、次の形式で 1 つの XML エレメント MESSAGE を認識するようにチャットアプリケーションに指示します。

<MESSAGE USER="John" TEXT="Hello, my name is John!" />. 
var socket:XMLSocket = new XMLSocket();

次の displayMessage() 関数は、ユーザーが受信したメッセージを表示するユーザー定義関数であるとします。

socket.onXML = function (doc) {
    var e = doc.firstChild;
    if (e != null && e.nodeName == "MESSAGE") {
        displayMessage(e.attributes.user, e.attributes.text);
    }
}

関連項目

Array 関数