load (LoadVars.load メソッド)

public load(url: String) : Boolean

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

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

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 ファイルをホストするサーバーに "クロスドメインポリシーファイル" を置いておく必要があります。

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

使用できるバージョン : ActionScript 1.0、Flash Lite 2.0 - Flash Player 7 で動作が変更されました。

パラメータ

url: String -ストリング。変数のダウンロード元の URL。呼び出し元の SWF ファイルが Web ブラウザで実行されている場合、url は 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/passvars.php");

"ActionScript" サンプルのフォルダの "guestbook.fla" ファイルにも例が収められています。通常、このフォルダへのパスは次のようになります。

load (LoadVars.load メソッド)

パラメータ

戻り値

例

関連項目