send (LoadVars.send メソッド)

public send(url: String, target: String, [method: String]) : Boolean

my_lv オブジェクト内の変数を、指定された URL に送信します。my_lv 内の列挙可能なすべての変数がデフォルトで application/x-www-form-urlencoded 形式のストリングとして 1 つに連結され、HTTP の POSTメソッドを使用して URL に送信されます。これは、loadVariables() で使用されるものと同じ形式です。HTTP リクエストヘッダーで送信される MIME コンテンツタイプは、my_lv.contentType の値、またはデフォルトの application/x-www-form-urlencoded です。GET を指定しなければ、POST メソッドが使用されます。

指定した URL のスクリプトまたはアプリケーションが確実に実行されるように、target パラメータを指定する必要があります。target パラメータを省略すると、true が返されますが、スクリプトまたはアプリケーションは実行されません。

次の場合は、send() メソッドが便利です。

send() メソッドの呼び出しが成功すると常に、新しいブラウザウィンドウが開くか、既存のウィンドウまたはフレームの内容が置き換わります。情報をサーバーに送り、新しいウィンドウを開いたり、ウィンドウやフレームの内容を置き換えたりせずに、SWF ファイルの再生を続行する場合は、LoadVars.sendAndLoad() を使用してください。

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

Flash のテスト環境では、常に GET メソッドを使用します。POST メソッドを使ってテストする場合は、ブラウザ内で使用してください。

使用できるバージョン : ActionScript 1.0、Flash Lite 2.0

パラメータ

url: String - ストリング。変数のアップロード先の URL。

target: String - ストリング。応答を表示するブラウザのウィンドウまたはフレーム。特定のウィンドウの名前を入力するか、次の予約されたターゲット名から選択します。

method: String (オプション) - ストリング。HTTP プロトコルの GET メソッドまたは POST メソッド。デフォルト値は POST です。

戻り値

Boolean - ブール値。パラメータが指定されていない場合は false、それ以外の場合は true。

次の例では、テキストフィールドから 2 つの値をコピーし、その情報を処理する CFM スクリプトに送信します。スクリプトでは、ユーザーがハイスコアを出したかどうかをチェックして、そのデータをデータベーステーブルに挿入するなどの処理を実行します。

var my_lv: LoadVars = new LoadVars();
my_lv.playerName = playerName_txt.text;
my_lv.playerScore = playerScore_txt.text;
my_lv.send("setscore.cfm", "_blank", "POST");

関連項目

sendAndLoad (LoadVars.sendAndLoad メソッド), send (XML.send メソッド)