User Guide

XMLSocket.connect() 485
If you specify null for the host parameter, the host contacted is the one where the SWF file
calling
XMLSocket.connect() resides. For example, if the SWF file was downloaded from
www.yoursite.com, specifying
null for the host parameter is the same as entering the IP address
for www.yoursite.com.
In SWF files running in a version of the player earlier than Flash Player 7,
host must be in the
same superdomain as the SWF file that is issuing this call. For example, a SWF file at
www.someDomain.com can load variables from a SWF file at store.someDomain.com because
both files are in the same superdomain of someDomain.com.
The value you pass for
url must be in exactly the same domain. For example, a SWF file at
www.someDomain.com can load variables only from SWF files that are also at
www.someDomain.com. If you want to load variables from a different domain, you can place a
cross-domain policy file on the server hosting the SWF file that is being accessed. For more
information, see “Applying Flex Security” in Developing Flex Applications.
When
load() is executed, the XML object property loaded is set to false. When the XML data
finishes downloading, the
loaded property is set to true, 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.
If
XMLSocket.connect() returns a value of true, the initial stage of the connection process is
successful; later, the
XMLSocket.onConnect method is invoked to determine whether the final
connection succeeded or failed. If
XMLSocket.connect() returns false, a connection could not
be established.
Example
The following example uses XMLSocket.connect() to connect to the host where the SWF
file resides and uses
trace to display the return value indicating the success or failure of
the connection:
var socket:XMLSocket = new XMLSocket()
socket.onConnect = function (success:Boolean) {
if (success) {
trace ("Connection succeeded!")
} else {
trace ("Connection failed!")
}
}
if (!socket.connect(null, 2000)) {
trace ("Connection failed!")
}
See also
function, XMLSocket.onConnect