Flash CS3 Documentation

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

send (XML.send method)

Encodes the specified XML object into an XML document and sends it to the specified target URL.

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 5

Parameters

url:String - The destination URL for the specified XML object.

target:String [optional] - The browser window to show data that the server returns:

• _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.

If you do not specify a target parameter, it is the same as specifying _self.

method:String [optional] - the method of the HTTP protocol used: either "GET" or "POST". In a browser, the default value is "POST". In the Flash test environment, the default value is "GET".

Returns

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

Example

The following example defines an XML packet and sets the content type for the XML object. The data is then sent to a server and shows a result in a browser window.

var my_xml:XML = new XML("<highscore><name>Ernie</name><score>13045</score></highscore>");
my_xml.contentType = "text/xml";
my_xml.send("http://www.flash-mx.com/mm/highscore.cfm", "_blank");

Press F12 to test this example in a browser.

See also

sendAndLoad (XML.sendAndLoad method)

Flash CS3