MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT - Page 781

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()