load (XML.load メソッド)

public load(url: String ) : Boolean

指定された URL から XML ドキュメントを読み込み、指定された XML オブジェクトの内容をダウンロードされた XML データで置き換えます。URL は相対 URL で、HTTP を使用して呼び出されます。ロード処理は非同期です。このため、load() メソッドの実行が完了しても、すぐには処理は終了しません。

load() メソッドを実行すると、XML オブジェクトの loaded プロパティが false に設定されます。XML データのダウンロードが終了すると、loaded プロパティが true に設定され、onLoad イベントハンドラが呼び出されます。XML データは、完全にダウンロードされるまで解析されません。XML オブジェクトに XML ツリーが既に含まれていた場合、その XML ツリーは破棄されます。

カスタム関数を定義して、XML オブジェクトの onLoad イベントハンドラが呼び出されたときに実行することができます。

メモ : ロード中のファイルに ASCII 文字以外の文字 (英語以外の多くの言語に存在する) が含まれている場合は、ASCII のような非 Unicode 形式ではなく UTF-8 または UTF-16 エンコーディング形式でファイルを保存することをお勧めします。

このメソッドを使用するときは、Flash Player セキュリティモデルを考慮してください。

Flash Player 8 :

呼び出し元 SWF ファイルがローカルファイルシステムのサンドボックスにあり、ターゲットリソースがネットワーク上のサンドボックスにある場合、データをロードできません。
呼び出し元 SWF ファイルがネットワーク上のサンドボックスにあり、ターゲットリソースがローカルにある場合、データをロードできません。

詳細については、次の参照先を参照してください。

『ActionScript 2.0 の学習』の「セキュリティについて」
Flash Player 9 セキュリティに関するホワイトペーパー (http://www.adobe.com/go/fp9_0_security_jp)
Flash Player 8 セキュリティ関連 API に関するホワイトペーパー (http://www.adobe.com/go/fp8_security_apis_jp)

Flash Player 7 以降では、クロスドメインポリシーファイルによって、Web サイトでのリソースへのクロスドメインアクセスを許可することができます。Flash Player 7 以降で SWF ファイルを実行している場合、url パラメータはまったく同じドメインに属している必要があります。たとえば、www.someDomain.com に存在する SWF ファイルは、store.someDomain.com に存在するソースからデータをロードできません。これは、両方のファイルが同じドメインに属していないためです。

Flash Player 7 より前のバージョンの Player で SWF ファイルを実行している場合、url パラメータは、呼び出し元の SWF ファイルと同じスーパードメインに属している必要があります。スーパードメインは、ファイルの URL の左端の要素を削除することで求められます。たとえば、www.someDomain.com に存在する SWF ファイルは、store.someDomain.com に存在するソースからデータをロードできます。これは、どちらのファイルも同じスーパードメイン someDomain.com に属しているためです。

対応バージョン : ActionScript 1.0、Flash Player 5 - Flash Player 7 ではビヘイビアが変更されました。

パラメータ

url:String - ロードする XML ドキュメントが置かれている場所の URL を表すストリング。呼び出し元の SWF ファイルが Web ブラウザで実行されている場合、url は SWF ファイルと同じドメインに属している必要があります。

戻り値

Boolean - ブール値。パラメータが指定されない (null が指定される) 場合は false、それ以外の場合は true が返されます。onLoad() イベントハンドラを使用して、XML ドキュメントが正常にロードされたかどうかをチェックします。

例

次のコードの例では、XML.load() メソッドを使用しています。

// Create a new XML object.
var flooring:XML = new XML();

// Set the ignoreWhite property to true (default value is false).
flooring.ignoreWhite = true;

// After loading is complete, trace the XML object.
flooring.onLoad = function(success) {
    trace(flooring);
};

// Load the XML into the flooring object.
flooring.load("flooring.xml");

flooring.xml ファイルの内容と、この例で生成される結果については、XML.ignoreWhite プロパティの例を参照してください。

load (XML.load メソッド)

パラメータ

戻り値

例

関連項目