public getBytesLoaded() : Number

XML ドキュメントに対してロード (ストリーミング) されたバイト数を返します。getBytesLoaded() の値と getBytesTotal() の値を比較すると、XML ドキュメントのロードされた割合を判断できます。

戻り値

Number - ロードされたバイト数を示す整数。

例

次の例では、XML.getBytesLoaded() メソッドと XML.getBytesTotal() メソッドを使用して、XML.load() コマンドの進行状況をトレースする方法を示します。XML.load() コマンドの URL パラメータは、HTTP を使用する有効な XML ファイルを指定するように値を置き換える必要があります。この例を使用してハードディスク上にあるローカルファイルをロードしようとしても、ムービープレビューモードの Flash Player ではローカルファイル全体がロードされるため、正常に機能しません。

// 新しい XML ドキュメントを作成します。
var doc:XML = new XML();

var checkProgress = function(xmlObj:XML) {
    var bytesLoaded:Number = xmlObj.getBytesLoaded();
    var bytesTotal:Number = xmlObj.getBytesTotal();
    var percentLoaded:Number = Math.floor((bytesLoaded / bytesTotal ) 100);
    trace ("milliseconds elapsed: " + getTimer());
    trace ("bytesLoaded: " + bytesLoaded);
    trace ("bytesTotal: " + bytesTotal);
    trace ("percent loaded: " + percentLoaded);
    trace ("---------------------------------");
}

doc.onLoad = function(success:Boolean) {
    clearInterval(intervalID);
    trace("intervalID: " + intervalID);
}
doc.load("[place a valid URL pointing to an XML file here]");
var intervalID:Number = setInterval(checkProgress, 100, doc);

関連項目

getBytesTotal (XML.getBytesTotal メソッド)