User Guide

226 Server-Side ActionScript Language Reference
The following displayMessage() function is assumed to be a user-defined function that
shows the message that the user receives:
socket.onXML = function (doc) {
var e = doc.firstChild;
if (e != null && e.nodeName == "MESSAGE") {
displayMessage(e.attributes.user, e.attributes.text);
}
}
XMLSocket.send()
Availability
Flash Media Server 2.
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 (0) 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 later. The
XMLSocket.send() method
does not return a value that indicates whether the data is successfully transmitted.
If the
myXMLSocket object is not connected to the server (using XMLSocket.connect()), the
XMLSocket.send() operation fails.
Example
The following example shows how you can specify a user name and password to send the
XML object
my_xml to the server:
var myXMLSocket = new XMLSocket();
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);