ActionScript 2.0 Components Language Reference |
|
|
|
| XMLConnector component > XMLConnector.multipleSimultaneousAllowed | |||
Flash Player 6 (6.0.79.0).
Flash MX Professional 2004.
componentInstance.multipleSimultaneousAllowed
Property; indicates whether multiple calls can take place at the same time. If this property is false, the XMLConnector.trigger() method performs a call if another call is already in progress. A status event is emitted, with the code CallAlreadyInProgress. If this property is true, the call takes place.
When multiple calls are simultaneously in progress, there is no guarantee that they will be completed in the order in which they were triggered. Also, the browser and/or operating system may place limits on the number of simultaneous network operations. The most likely limit you may encounter is the browser enforcing a maximum number of URLs that can be downloaded simultaneously. This is something that is often configurable in a browser. However, even in this case, the browser should queue streams, and this should not interfere with the expected behavior of the Flash application.
This example retrieves a remote XML file using the XMLConnector component by setting the direction property to receive. Drag an XMLConnector component into your library, and enter the following code on Frame 1 of the timeline:
import mx.data.components.XMLConnector;
var xmlListener:Object = new Object();
xmlListener.result = function(evt:Object) {
trace("results:");
trace(evt.target.results);
trace("");
};
xmlListener.status = function(evt:Object) {
trace("status::"+evt.code);
};
var myXMLConnector:XMLConnector = new XMLConnector();
myXMLConnector.addEventListener("result", xmlListener);
myXMLConnector.addEventListener("status", xmlListener);
myXMLConnector.direction = "receive";
myXMLConnector.URL = "http://www.flash-mx.com/mm/tips/tips.xml";
myXMLConnector.multipleSimultaneousAllowed = false;
myXMLConnector.suppressInvalidCalls = true;
myXMLConnector.trigger();
myXMLConnector.trigger();
myXMLConnector.trigger();
This example specifies the URL of the XML file, and sets multipleSimultaneousAllowed to false. It triggers the XMLConnector instance three times, which causes the event listener's status method to display the error code CallAlreadyInProgress two times in the Output panel. The first attempt is successfully sent from Flash to the server. When the first trigger successfully receives a result, the result event is broadcast and the XML packet you receive is displayed in the Output panel.
|
|
|
|