| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
La classe XMLList fornisce i metodi per eseguire operazioni con uno o più elementi XML. Un oggetto XMLList può rappresentare uno o più oggetti o elementi XML, quali nodi o attributi, e consente di chiamare i metodi sugli elementi come gruppo unico o sui singoli elementi della raccolta.
Se un oggetto XMLList dispone di un solo elemento XML, i metodi della classe XML possono essere utilizzati direttamente sull'oggetto XMLList. Nell'esempio seguente, example.two è un oggetto XMLList di lunghezza 1 e consente di chiamare su di esso qualunque metodo XML.
var example2 = <example><two>2</two></example>;
Se si tenta di utilizzare i metodi della classe XML con un oggetto XMLList contenente più oggetti XML, viene generata un'eccezione; in questo caso, è opportuno invece eseguire un'iterazione sulla raccolta XMLList (ad esempio utilizzando un'istruzione for each..in) e applicare i metodi a ogni oggetto XML della raccolta.
Vedere gli esempi
public function XMLList(value:Object)
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Crea un nuovo oggetto XMLList.
Parametri
| value:Object — Qualunque oggetto che può essere convertito in un oggetto XMLList utilizzando la funzione XMLList() di primo livello.
|
Vedere anche
AS3 function attribute(attributeName:*):XMLList
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Chiama il metodo attribute() di ciascun oggetto XML e restituisce un oggetto XMLList dei risultati. I risultati corrispondono al parametro attributeName dato. Se non è presente alcuna corrispondenza, il metodo attribute() restituisce un oggetto XMLList vuoto.
Parametri
| attributeName:* — Il nome dell'attributo che si desidera includere in un oggetto XMLList.
|
Restituisce
| XMLList — Un oggetto XMLList di oggetti XML corrispondenti o un oggetto XMLList vuoto.
|
Vedere anche
AS3 function attributes():XMLList
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Chiama il metodo attributes() di ciascun oggetto XML e restituisce un oggetto XMLList di attributi per ogni oggetto XML.
Restituisce
| XMLList — Un oggetto XMLList di attributi per ogni oggetto XML.
|
Vedere anche
AS3 function child(propertyName:Object):XMLList
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Chiama il metodo child() di ciascun oggetto XML e restituisce un oggetto XMLList che contiene i risultati in ordine.
Parametri
| propertyName:Object — Il nome dell'elemento o l'intero dell'elemento XML secondario.
|
Restituisce
| XMLList — Un oggetto XMLList di nodi secondari che corrispondono al parametro di input.
|
Vedere anche
AS3 function children():XMLList
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Chiama il metodo children() di ciascun oggetto XML e restituisce un oggetto XMLList che contiene i risultati.
Restituisce
| XMLList — Un oggetto XMLList degli elementi secondari negli oggetti XML.
|
Vedere anche
AS3 function comments():XMLList
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Chiama il metodo comments() di ciascun oggetto XML e restituisce un oggetto XMLList di commenti.
Restituisce
| XMLList — Un oggetto XMLList dei commenti negli oggetti XML.
|
Vedere anche
AS3 function contains(value:XML):Boolean
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Verifica se l'oggetto XMLList contiene un oggetto XML uguale al parametro value dato.
Parametri
| value:XML — Un oggetto XML da confrontare con l'oggetto XMLList corrente.
|
Restituisce
| Boolean — Se l'oggetto XMLList contiene l'oggetto XML dichiarato nel parametro value, viene restituito true; in caso contrario, false.
|
Vedere anche
AS3 function copy():XMLList
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce una copia dell'oggetto XMLList dato. La copia è un duplicato dell'intera struttura ad albero di nodi. L'oggetto XML copiato non ha un elemento principale e restituisce null se si tenta di chiamare il metodo parent().
Restituisce
| XMLList — Una copia dell'oggetto XMLList.
|
Vedere anche
AS3 function descendants(name:Object = *):XMLList
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce tutti gli elementi discendenti (secondari, inferiori di due livelli, inferiori di tre livelli, e così via) dell'oggetto XML che hanno il parametro name dato. Il parametro name può essere un oggetto QName, un tipo di dati String o qualunque altro tipo di dati che viene successivamente convertito in un tipo di dati String.
Per restituire tutti gli elementi discendenti, utilizzare il parametro asterisco (*). Se non viene passato alcun parametro, viene passata la stringa "*" che restituisce tutti i discendenti dell'oggetto XML.
Parametri
| name:Object (default = *) — Il nome dell'elemento per cui deve essere cercata una corrispondenza.
|
Restituisce
| XMLList — Un oggetto XMLList degli elementi discendenti corrispondenti (secondari, inferiori di due livelli, inferiori di tre livelli, e così via) degli oggetti XML. Se non sono presenti dei discendenti, restituisce un oggetto XMLList vuoto.
|
Vedere anche
AS3 function elements(name:Object = *):XMLList
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Chiama il metodo elements() di ogni oggetto XML. Il parametro name viene passato al metodo descendants(). Se non viene passato alcun parametro, la stringa "*" viene passata al metodo descendants().
Parametri
| name:Object (default = *) — Il nome degli elementi per cui deve essere cercata una corrispondenza.
|
Restituisce
| XMLList — Un oggetto XMLList degli elementi secondari corrispondenti negli oggetti XML.
|
Vedere anche
AS3 function hasComplexContent():Boolean
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Verifica se nell'oggetto XMLList è presente del contenuto complesso. Un oggetto XMLList ha del contenuto complesso se non è vuoto o se una delle condizioni seguenti è true:
- L'oggetto XMLList contiene un solo elemento XML con contenuto complesso.
- L'oggetto XMLList contiene degli elementi.
Restituisce
| Boolean — Se nell'oggetto XMLList è presente del contenuto complesso, viene restituito true; in caso contrario false.
|
Vedere anche
AS3 function hasOwnProperty(p:String):Boolean
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Verifica la presenza della proprietà specificata da p.
Parametri
| p:String — La proprietà per cui deve essere trovata la corrispondenza.
|
Restituisce
| Boolean — Se il parametro esiste, viene restituito true; in caso contrario false.
|
Vedere anche
AS3 function hasSimpleContent():Boolean
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Verifica se nell'oggetto XMLList è presente del contenuto semplice. Un oggetto XMLList ha del contenuto semplice se una o più condizioni seguenti sono true:
- L'oggetto XMLList è vuoto
- L'oggetto XMLList contiene un solo elemento XML con contenuto semplice
- L'oggetto XMLList non contiene elementi
Restituisce
| Boolean — Se nell'oggetto XMLList è presente del contenuto semplice, viene restituito true; in caso contrario false.
|
Vedere anche
AS3 function length():int
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce il numero di proprietà nell'oggetto XMLList.
Restituisce
| int — Il numero di proprietà nell'oggetto XMLList.
|
Vedere anche
AS3 function normalize():XMLList
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Unisce i nodi di testo adiacenti ed elimina i nodi di testo vuoti per ognuno degli elementi seguenti: tutti i nodi di testo nell'oggetto XMLList, tutti gli oggetti XML contenuti in XMLList e i discendenti di tutti gli oggetti XML in XMLList.
Restituisce
| XMLList — L'oggetto XMLList normalizzato.
|
Vedere anche
AS3 function parent():Object
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce l'elemento principale dell'oggetto XMLList se tutti gli elementi nell'oggetto XMLList hanno lo stesso elemento principale. Se l'oggetto XMLList non ha elementi principali o ha elementi principali diversi, il metodo restituisce undefined.
Restituisce
| Object — Restituisce l'oggetto XML principale.
|
Vedere anche
AS3 function processingInstructions(name:String = "*"):XMLList
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Se viene fornito un parametro name, elenca tutti gli elementi secondari dell'oggetto XMLList che contengono le istruzioni di elaborazione con tale nome. In assenza di parametri, il metodo elenca tutti gli elementi secondari dell'oggetto XMLList che contengono delle eventuali istruzioni di elaborazione.
Parametri
| name:String (default = "*") — Il nome delle istruzioni di elaborazione per cui deve essere cercata una corrispondenza.
|
Restituisce
| XMLList — Un oggetto XMLList che contiene le istruzioni di elaborazione per ogni oggetto XML.
|
Vedere anche
AS3 function propertyIsEnumerable(p:String):Boolean
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Verifica se la proprietà p fa parte del gruppo di proprietà di cui è possibile eseguire l'iterazione in un'istruzione for..in applicata all'oggetto XMLList. Restituisce true solo se toNumber(p) è maggiore o uguale a 0 e inferiore alla lunghezza dell'oggetto XMLList.
Parametri
| p:String — L'indice di una proprietà da verificare.
|
Restituisce
| Boolean — Se della proprietà è possibile effettuare l'iterazione in un'istruzione for..in, viene restituito true; in caso contrario, false.
|
Vedere anche
AS3 function text():XMLList
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Chiama il metodo text() di ciascun oggetto XML e restituisce un oggetto XMLList che contiene i risultati.
Restituisce
| XMLList — Un oggetto XMLList di tutte le proprietà XML dell'oggetto XMLList che rappresentano i nodi di testo XML.
|
Vedere anche
AS3 function toString():String
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce una rappresentazione in formato stringa di tutti gli oggetti XML in un oggetto XMLList. Le regole per questa conversione dipendono dal fatto che nell'oggetto XML sia presente del contenuto complesso o del contenuto semplice:
- Se nell'oggetto XML è presente del contenuto semplice,
toString() restituisce il contenuto di stringa dell'oggetto XML senza gli elementi seguenti: il tag iniziale, gli attributi, le dichiarazioni degli spazi dei nomi e il tag finale.
- Se nell'oggetto XML è presente del contenuto complesso,
toString() restituisce una stringa con codifica XML che rappresenta l'intero oggetto XML, compresi il tag iniziale, gli attributi, le dichiarazioni degli spazi dei nomi e il tag finale.
Per restituire ogni volta l'intero oggetto XML, utilizzare il metodo toXMLString().
Restituisce
| String — La rappresentazione in formato stringa dell'oggetto XML.
|
Vedere anche
Esempio
L'esempio seguente mostra il risultato del metodo
toString() quando nell'oggetto XML è presente del contenuto semplice:
var test:XML = <type name="Joe">example</type>;
trace(test.toString()); //example
L'esempio seguente mostra il risultato del metodo
toString() quando nell'oggetto XML è presente del contenuto complesso:
var test:XML =
<type name="Joe">
<base name="Bob"></base>
example
</type>;
trace(test.toString());
// <type name="Joe">
// <base name="Bob"/>
// example
// </type>
AS3 function toXMLString():String
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce una rappresentazione in formato stringa di tutti gli oggetti XML in un oggetto XMLList. A differenza del metodo toString(), il metodo toXMLString() restituisce sempre il tag iniziale, gli attributi e il tag finale dell'oggetto XML, a prescindere dal contenuto (semplice o complesso) dell'oggetto XML. (Il metodo toString() esclude questi elementi negli oggetti XML con contenuto semplice.)
Restituisce
| String — La rappresentazione in formato stringa dell'oggetto XML.
|
Vedere anche
AS3 function valueOf():XMLList
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce l'oggetto XMLList.
Restituisce
| XMLList — Restituisce l'oggetto XMLList corrente.
|
Vedere anche
Nell'esempio seguente viene creata una proprietà XML denominata
books e vengono aggiunte numerose voci con i tag
book publisher e
name a un nodo denominato
books. Quindi, viene chiamato il metodo
showBooksByPublisher() che accetta l'oggetto XMLList e restituisce ogni voce corrispondente all'editore "Addison-Wesley".
package {
import flash.display.Sprite;
public class XMLListExample extends Sprite {
private var books:XML;
public function XMLListExample() {
books = <books>
<book publisher="Addison-Wesley" name="Design Patterns" />
<book publisher="Addison-Wesley" name="The Pragmatic Programmer" />
<book publisher="Addison-Wesley" name="Test Driven Development" />
<book publisher="Addison-Wesley" name="Refactoring to Patterns" />
<book publisher="O'Reilly Media" name="The Cathedral & the Bazaar" />
<book publisher="O'Reilly Media" name="Unit Test Frameworks" />
</books>;
showBooksByPublisher("Addison-Wesley");
}
private function showBooksByPublisher(name:String):void {
var results:XMLList = books.book.(@publisher == name);
showList(results);
}
private function showList(list:XMLList):void {
var item:XML;
for each(item in list) {
trace("item: " + item.toXMLString());
}
}
}
}
© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Fri Oct 12 2007, 3:14 AM GMT-07:00
Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/XMLList.html