Flash CS3 ドキュメンテーション

ActionScript 2.0 リファレンスガイド > ActionScript クラス > LoadVars > load (LoadVars.load メソッド)

load (LoadVars.load メソッド)

public load(url: String ) : Boolean

指定された URL から変数をダウンロードし、変数データを解析し、結果として得られた変数を my_lv に代入します。my_lv のプロパティのうち、ダウンロードされた変数と名前が同じものは上書きされます。my_lv のプロパティのうち、ダウンロードされた変数と名前が異なるものは削除されません。これは非同期アクションです。

ダウンロードされたデータは、MIME コンテンツタイプ application/x-www-form-urlencoded である必要があります。

これは loadVariables() で使用されるのと同じ形式です。

また、Flash Player 7 用にパブリッシュされたファイルでは、LoadVars.load() でロードされる外部変数の大文字と小文字の区別に対応しています。

このメソッドは XML.load() と似ています。

メモ : ロード中のファイルに 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 6 - Flash Player 7 ではビヘイビアが変更されました。

パラメータ

url:String -ストリング。変数のダウンロード元の URL。呼び出し元の SWF ファイルが Web ブラウザ内で実行している場合、host は SWF ファイルと同じドメインに属している必要があります。

戻り値

Boolean - パラメータが渡されなかった場合 (パラメータが null の場合) は false、それ以外の場合は true を返します。データのロードに成功したかどうかを確認するには、onLoad() イベントハンドラを使用します。

例

次のコードでは、サーバー側の PHP スクリプトから Flash アプリケーションにデータが返されたことを通知する onLoad ハンドラ関数を定義した後、データを passvars.php にロードします。

var my_lv:LoadVars = new LoadVars();
my_lv.onLoad = function(success:Boolean) {
    if (success) {
    trace(this.toString());
    } else {
    trace("Error loading/parsing LoadVars.");
    }
};
my_lv.load("http://www.helpexamples.com/flash/params.txt");

別の例については、Flash サンプルページ (www.adobe.com/go/learn_fl_samples_jp) を参照してください。"Samples" zip ファイルをダウンロードし解凍して、"ActionScript2.0/DataIntegration\Guestbook" フォルダに移動して guestbook.fla ファイルにアクセスします。

load (LoadVars.load メソッド)

パラメータ

戻り値

例

関連項目