MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT, Reference Manual

Page: 781 / 816

XMLSocket.send() 781
The
onXML
handler must first be installed in the XMLSocket object as follows:
socket.onXML = myOnXML;
The function
displayMessage()
is assumed to be a user-defined function that displays the
message received by the user.
function myOnXML(doc) {
var e = doc.firstChild;
if (e != null && e.nodeName == "MESSAGE") {
displayMessage(e.attributes.user, e.attributes.text);
}
}
See also
function
XMLSocket.send()
Availability
Flash Player 5.
Usage
myXMLSocket .send( object )
Parameters
object
An XML object or other data to transmit to the server.
Returns
Nothing.
Description
Method; converts the XML object or data specified in the
object
parameter to a string and
transmits it to the server, followed by a zero byte. If
object
is an XML object, the string is the
XML textual representation of the XML object. The send operation is asynchronous; it returns
immediately, but the data may be transmitted at a later time. The
XMLSocket.send()
method
does not return a value indicating whether the data was successfully transmitted.
If the
myXMLSocket
object is not connected to the server (using
XMLSocket.connect()
), the
XMLSocket.send()
operation will fail.
Example
The following example illustrates how you could specify a user name and password to send the
XML object
my_xml
to the server:
var my_xml = new XML();
var myLogin = my_xml.createElement("login");
myLogin.attributes.username = usernameTextField;
myLogin.attributes.password = passwordTextField;
my_xml.appendChild(myLogin);
myXMLSocket.send(my_xml);
See also
XMLSocket.connect()