パッケージflash.net
public dynamic class URLVariables
継承URLVariables Inheritance Object

URLVariables クラスを使用して、Flash® アプリケーションとサーバーの間で変数を転送できます。URLVariables オブジェクトは URLLoader クラスのメソッド、URLRequest クラスの data プロパティ、および flash.net パッケージ関数で使用してください。

例の表示

関連項目

URLLoader
外部データの操作


パブリックプロパティ
 プロパティ定義
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリックメソッド
 メソッド定義
  URLVariables(source:String = null)
新しい URLVariables オブジェクトを作成します。
URLVariables
  decode(source:String):void
変数ストリングを、指定された URLVariables オブジェクトのプロパティに変換します。
URLVariables
 InheritedhasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 InheritedisPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 InheritedpropertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙可能かどうかを示します。
Object
 InheritedsetPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  toString():String
列挙可能な変数をすべて含むストリングを、MIME コンテンツエンコード application/x-www-form-urlencoded で返します。
URLVariables
 InheritedvalueOf():Object
指定されたオブジェクトのプリミティブ値を返します。
Object
コンストラクタの詳細
URLVariables()コンストラクタ
public 関数 URLVariables(source:String = null)

新しい URLVariables オブジェクトを作成します。URLVariables オブジェクトを URLRequest オブジェクトの data プロパティに渡します。

ストリングとともに URLVariables コンストラクタを呼び出すと、decode() メソッドが自動的に呼び出されて、そのストリングが URLVariables オブジェクトのプロパティに変換されます。

パラメータ
source:String (default = null) — 名前と値のペアを含む、URL エンコードされたストリングです。
メソッドの詳細
decode()メソッド
public function decode(source:String):void

変数ストリングを、指定された URLVariables オブジェクトのプロパティに変換します。

このメソッドは、URLVariables イベントによって内部的に使用されます。ほとんどの場合、ユーザーが直接このメソッドを呼び出す必要はありません。

パラメータ
source:String — 名前と値のペアを含む、URL エンコードされたクエリーストリングです。

スロー
Error — ソースパラメータは、名前と値のペアを含む、URL エンコーディングされたクエリーストリングでなければなりません。

関連項目

toString()メソッド 
public function toString():String

列挙可能な変数をすべて含むストリングを、MIME コンテンツエンコード application/x-www-form-urlencoded で返します。

戻り値
String — 名前と値のペアを含む、URL エンコードされたストリングです。

次の例では、新しいウィンドウで http://www.[yourDomain].com/application.jsp でホストされるリモート アプリケーションを開き、 URLVariables オブジェクトで捕捉したユーザーセッションに関するデータをアプリケーションに渡します。

この例のハイライトは、次のとおりです。

  1. コンストラクタ関数は request という名前の、リモートアプリケーションの URL をパラメータとして取る URLRequest インスタンスを作成します。
  2. URLVariables オブジェクトが作成され、その 2 つのプロパティに値が割り当てられます。
  3. URLVariables オブジェクトが URLRequest オブジェクトのdata プロパティに割り当てられます。
  4. この例では、navigateToURL を呼び出して、新しいブラウザウィンドウを開き、 リモートアプリケーションの URL に接続します。

メモ: この例を実行するには、この例のリモートアプリケーションの URL を 実際の URL に置き換える必要があります。さらに、 URLVariables オブジェクトの Flash Player で捕捉した情報を処理するためのサーバーコードが必要です。

package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLVariables;

    public class URLVariablesExample extends Sprite {

        public function URLVariablesExample() {
            var url:String = "http://www.[yourDomain].com/application.jsp";
            var request:URLRequest = new URLRequest(url);
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date().getTime();
            variables.exampleUserLabel = "guest";
            request.data = variables;
            navigateToURL(request);
        }
    }
}