User Guide

XMLSocket.send() 1069

XMLSocket.send()

Availability

Flash Player 5.

Usage

myXMLSocket.send(object:XML) : Void

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 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 shows how you could specify a user name and password to send the XML

object

my_xml to the server:

var myXMLSocket:XMLSocket = new XMLSocket();

var my_xml:XML = new XML();

var myLogin:XMLNode = my_xml.createElement("login");

myLogin.attributes.username = usernameTextField;

myLogin.attributes.password = passwordTextField;

my_xml.appendChild(myLogin);

myXMLSocket.send(my_xml);