Flash CS3 Documentation

ActionScript 2.0 Language Reference > ActionScript classes > LoadVars > send (LoadVars.send method)

send (LoadVars.send method)

Sends the variables in the my_lv object to the specified URL. All enumerable variables in my_lv are concatenated into a string in the application/x-www-form-urlencoded format by default, and the string is posted to the URL using the HTTP POST method. This is the same format used by loadVariables().The MIME content type sent in the HTTP request headers is the value of my_lv.contentType or the default application/x-www-form-urlencoded. The POST method is used unless GET is specified.

You must specify the target parameter to ensure that the script or application at the specified URL will be executed. If you omit the target parameter, the function will return true, but the script or application will not be executed.

The send() method is useful if you want the server response to:

• Replace the SWF content (use "_self" as the target parameter);
• Appear in a new window (use "_blank" as the target parameter);
• Appear in the parent or top-level frame (use "_parent" or "_top" as the target parameter);
• Appear in a named frame (use the frame's name as a string for the target parameter).

A successful send() method call will always open a new browser window or replace content in an existing window or frame. If you would rather send information to a server and continue playing your SWF file without opening a new window or replacing content in a window or frame, then you should use LoadVars.sendAndLoad().

This method is similar to XML.send().

The Flash test environment always uses the GET method. To test using the POST method, be sure you are attempting to use it from within a browser.

When using this method, consider the Flash Player security model:

• For Flash Player 8, the method is not allowed if the calling SWF file is in an untrusted local sandbox.
• For Flash Player 7 and later, the method is not allowed if the calling SWF file is a local file.

For more information, see the following:

• "Understanding Security" in Learning ActionScript 2.0 in Flash
• The Flash Player 9 Security white paper at http://www.adobe.com/go/fp9_0_security
• The Flash Player 8 Security-Related API white paper at http://www.adobe.com/go/fp8_security_apis

Availability: ActionScript 1.0; Flash Player 6

Parameters

url:String - A string; the URL to which to upload variables.

target:String - A string; the browser window or frame in which any response will appear. You can enter the name of a specific window or select from the following reserved target names:

• "_self" specifies the current frame in the current window.
• "_blank" specifies a new window.
• "_parent" specifies the parent of the current frame.
• "_top" specifies the top-level frame in the current window.

method:String [optional] - A string; the GET or POST method of the HTTP protocol. The default value is POST.

Returns

Boolean - A Boolean value; false if no parameters are specified, true otherwise.

Example

The following example copies two values from text fields and sends the data to a CFM script, which is used to handle the information. For example, the script might check if the user got a high score and then insert that data into a database table.

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");

See also

sendAndLoad (LoadVars.sendAndLoad method), send (XML.send method)

Flash CS3