public load(url:String) : Boolean

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

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

Flash Player 7 以降で SWF ファイルを実行している場合、url パラメータは正確に同じドメインに置かれている必要があります。たとえば www.someDomain.com に置かれている SWF ファイルは、www.someDomain.com に置かれているソースからのみデータをロードできます。異なるドメインからデータをロードする場合は、SWF ファイルをホストするサーバーに "クロスドメインポリシーファイル" を置いておく必要があります。

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

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

パラメータ

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

戻り値

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

例

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

// 新しい XML オブジェクトを作成します
var flooring:XML = new XML();

// ignoreWhite プロパティを true に設定します (デフォルト値は false)
flooring.ignoreWhite = true;

// ロードの完了後、XML オブジェクトをトレースします
flooring.onLoad = function(success) {
 trace(flooring);
};

// XML を flooring オブジェクトにロードします
flooring.load("flooring.xml");

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

関連項目

ignoreWhite (XML.ignoreWhite プロパティ), loaded (XML.loaded プロパティ), onLoad (XML.onLoad ハンドラ)