User Guide

XML.sendAndLoad() 1051
XML.sendAndLoad()
Availability
Flash Player 5; behavior changed in Flash Player 7.
Usage
my_xml.sendAndLoad(url:String, targetXMLobject:XML) : Void
Parameters
url
A string; the destination URL for the specified XML object. If the SWF file issuing this call
is running in a web browser,
url must be in the same domain as the SWF file; for details, see the
Description section.
targetXMLobject An XML object created with the XML constructor method that will receive
the return information from the server.
Returns
Nothing.
Description
Method; encodes the specified XML object into an XML document, sends it to the specified
URL using the
POST method, downloads the server’s response, and loads it into the
targetXMLobject specified in the parameters. The server response loads in the same manner
used by the
XML.load() method.
In SWF files running in a version of the player earlier than Flash Player 7, the
url parameter must
be in the same superdomain as the SWF file that is issuing this call. A superdomain is derived by
removing the left-most component of a file’s URL. For example, a SWF file at
www.someDomain.com can load data from sources at store.someDomain.com, because both files
are in the same superdomain of someDomain.com.
In SWF files of any version running in Flash Player 7 or later, the
url parameter must be in
exactly the same domain (see “Flash Player security features” in Using ActionScript in Flash). For
example, a SWF file at www.someDomain.com can load data only from sources that are also at
www.someDomain.com. If you want to load data from a different domain, you can place a cross-
domain policy file on the server hosting the SWF file. For more information, see “About allowing
cross-domain data loading” in Using ActionScript in Flash.
When
sendAndLoad() is executed, the XML object property loaded is set to false. When the
XML data finishes downloading, the
loaded property is set to true if the data successfully
loaded, and the
onLoad event handler is invoked. The XML data is not parsed until it is
completely downloaded. If the XML object previously contained any XML trees, they are
discarded.
Example
The following example includes ActionScript for a simple e-commerce storefront application.
The
XML.sendAndLoad() method transmits an XML element that contains the user’s name and
password, and uses an
onLoad handler to process the reply from the server.