URLVariables

套件	flash.net
類別	public dynamic class URLVariables
繼承	URLVariables Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

URLVariables 類別可讓您在應用程式和伺服器之間傳輸變數。請使用 URLVariables 物件搭配 URLLoader 類別的方法、URLRequest 類別的 data 屬性以及 flash.net 套件函數。

相關 API 元素

公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		URLVariables(source:String = null) 會建立新的 URLVariables 物件。	URLVariables
		decode(source:String):void 會將變數字串轉換成指定之 URLVariables 物件的屬性。	URLVariables
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 在 MIME 內容編碼的 application/x-www-form-urlencoded 中，傳回包含所有可列舉變數的字串。	URLVariables
		valueOf():Object 會傳回指定之物件的基本值。	Object

建構函式詳細資料

()

建構函式

public function URLVariables(source:String = null)

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會建立新的 URLVariables 物件。您可以將 URLVariables 物件傳遞給 URLRequest 物件的 data 屬性。

如果您使用字串來呼叫 URLVariables 建構函式，則會自動呼叫 decode() 方法，以便將字串轉換成 URLVariables 物件的屬性。

參數

source:String (default = null) — URL 編碼的字串，其中包含名稱/值的配對。

方法詳細資訊

decode

()

方法

public function decode(source:String):void

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會將變數字串轉換成指定之 URLVariables 物件的屬性。

此方法是由 URLVariables 事件在內部使用。大部分的使用者毋須直接呼叫此方法。

參數

source:String — 經過 URL 編碼的查詢字串，其中包含名稱/值的配對。

擲回值

Error — 原始參數必須是經過 URL 編碼的查詢字串 (其中包含名稱/值的配對)。

範例 ( 如何使用本範例 )

下列範例顯示您可以剖析 URL 編碼字串的方法。範例由 ActionScriptExamples.com 提供。

// The first method passes the string to be decoded to the URLVariables class constructor:
var urlVariables:URLVariables = new URLVariables("firstName=Tom&lastName=Jones");
lbl.text = urlVariables.lastName + "," + urlVariables.firstName;

// The second method uses the decode() method to parse the URL encoded string:
var urlVariables:URLVariables = new URLVariables();
urlVariables.decode("firstName=Tom&lastName=Jones");
lbl.text = urlVariables.lastName + "," + urlVariables.firstName;

toString

()

方法

public function toString():String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會在 MIME 內容編碼的 application/x-www-form-urlencoded 中，傳回包含所有可列舉變數的字串。

傳回值

String — URL 編碼的字串，其中包含名稱/值的配對。

範例如何使用本範例

URLVariablesExample.as

下列範例會在新瀏覽器視窗中開啟裝載於 http://www.[yourDomain].com/application.jsp 的遠端應用程式，將 URLVariables 物件所捕捉的使用者工作階段資料傳遞給應用程式。

此範例的重點如下：

建構函數會建立 URLRequest 實體 request，將遠端應用程式的 URL 做為參數。
然後建立一個 URLVariables 物件，並將值指定給其中兩個屬性。
會將 URLVariables 物件指定給 URLRequest 物件的 data 屬性。
範例中會呼叫 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);
        }
    }
}

法律聲明 | 線上隱私權政策

URLVariables - AS3

類別 x

URLVariables

decode

toString