| Pacchetto | Primo livello |
| Classe | public final dynamic class XMLList |
| Ereditarietà | XMLList  Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 tentate 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.
Altri esempi
Assemblaggio e trasformazione di oggetti XML
Lettura delle strutture XML
Uso degli spazi dei nomi XML
Conversione degli oggetti XML
Conversione degli oggetti XML e XMLList in stringhe
Lettura di documenti XML esterni
Esempio di XML in ActionScript: caricamento di dati RSS da Internet
Altre informazioni
Nozioni di base su XML
L'approccio E4X all'elaborazione XML
Oggetti XML
Oggetti XMLList
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Metodo | Definito da | ||
|---|---|---|---|
Crea un nuovo oggetto XMLList. | XMLList | ||
Chiama il metodo attribute() di ciascun oggetto XML e restituisce un oggetto XMLList dei risultati. | XMLList | ||
Chiama il metodo attributes() di ciascun oggetto XML e restituisce un oggetto XMLList di attributi per ogni oggetto XML. | XMLList | ||
Chiama il metodo child() di ciascun oggetto XML e restituisce un oggetto XMLList che contiene i risultati in ordine. | XMLList | ||
Chiama il metodo children() di ciascun oggetto XML e restituisce un oggetto XMLList che contiene i risultati. | XMLList | ||
Chiama il metodo comments() di ciascun oggetto XML e restituisce un oggetto XMLList di commenti. | XMLList | ||
Verifica se l'oggetto XMLList contiene un oggetto XML uguale al parametro value dato. | XMLList | ||
Restituisce una copia dell'oggetto XMLList specifico. | XMLList | ||
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. | XMLList | ||
Chiama il metodo elements() di ogni oggetto XML. | XMLList | ||
Verifica se nell'oggetto XMLList è presente del contenuto complesso. | XMLList | ||
Verifica la presenza della proprietà specificata da p. | XMLList | ||
Verifica se nell'oggetto XMLList è presente del contenuto semplice. | XMLList | ||
 |
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
Restituisce il numero di proprietà nell'oggetto XMLList. | XMLList | ||
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. | XMLList | ||
Restituisce l'elemento principale dell'oggetto XMLList se tutti gli elementi nell'oggetto XMLList hanno lo stesso elemento principale. | XMLList | ||
Se viene fornito un parametro name, elenca tutti gli elementi secondari dell'oggetto XMLList che contengono le istruzioni di elaborazione con tale nome. | XMLList | ||
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. | XMLList | ||
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
Chiama il metodo text() di ciascun oggetto XML e restituisce un oggetto XMLList che contiene i risultati. | XMLList | ||
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
Restituisce una rappresentazione in formato stringa di tutti gli oggetti XML in un oggetto XMLList. | XMLList | ||
Restituisce una rappresentazione in formato stringa di tutti gli oggetti XML in un oggetto XMLList. | XMLList | ||
Restituisce l'oggetto XMLList. | XMLList | ||
XMLList | () | Funzione di costruzione |
public function XMLList(value:Object)| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Crea un nuovo oggetto XMLList.
Parametrivalue:Object — Qualunque oggetto che può essere convertito in un oggetto XMLList utilizzando la funzione XMLList() di primo livello.
|
Elementi API correlati
attribute | () | metodo |
AS3 function attribute(attributeName:*):XMLList| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, 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 desiderate includere in un oggetto XMLList.
|
XMLList — Un oggetto XMLList di oggetti XML corrispondenti o un oggetto XMLList vuoto.
|
Altre informazioni
Elementi API correlati
attributes | () | metodo |
AS3 function attributes():XMLList| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Chiama il metodo attributes() di ciascun oggetto XML e restituisce un oggetto XMLList di attributi per ogni oggetto XML.
XMLList — Un oggetto XMLList di attributi per ogni oggetto XML.
|
Altre informazioni
Elementi API correlati
child | () | metodo |
AS3 function child(propertyName:Object):XMLList| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, 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.
|
XMLList — Un oggetto XMLList di nodi secondari che corrispondono al parametro di input.
|
Altre informazioni
Elementi API correlati
children | () | metodo |
AS3 function children():XMLList| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Chiama il metodo children() di ciascun oggetto XML e restituisce un oggetto XMLList che contiene i risultati.
XMLList — Un oggetto XMLList degli elementi secondari negli oggetti XML.
|
Altre informazioni
Elementi API correlati
comments | () | metodo |
AS3 function comments():XMLList| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Chiama il metodo comments() di ciascun oggetto XML e restituisce un oggetto XMLList di commenti.
XMLList — Un oggetto XMLList dei commenti negli oggetti XML.
|
Altre informazioni
Elementi API correlati
contains | () | metodo |
AS3 function contains(value:XML):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, 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.
|
Boolean — Se l'oggetto XMLList contiene l'oggetto XML dichiarato nel parametro value, viene restituito true; in caso contrario, false.
|
Altre informazioni
copy | () | metodo |
AS3 function copy():XMLList| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Restituisce una copia dell'oggetto XMLList specifico. 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().
XMLList — Una copia dell'oggetto XMLList.
|
Altre informazioni
descendants | () | metodo |
AS3 function descendants(name:Object = *):XMLList| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, 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, utilizzate il parametro asterisco (*). Se non passate alcun parametro, viene passata la stringa "*" che restituisce tutti i discendenti dell'oggetto XML.
Parametri
name:Object (default = *) |
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.
|
Altre informazioni
Elementi API correlati
elements | () | metodo |
AS3 function elements(name:Object = *):XMLList| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Chiama il metodo elements() di ogni oggetto XML. Il parametro name viene passato al metodo descendants(). Se non passate alcun parametro, la stringa "*" viene passata al metodo descendants().
Parametri
name:Object (default = *) |
XMLList — Un oggetto XMLList degli elementi secondari corrispondenti negli oggetti XML.
|
Elementi API correlati
hasComplexContent | () | metodo |
AS3 function hasComplexContent():Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Verifica se nell'oggetto XMLList è presente un contenuto complesso. Un oggetto XMLList include un contenuto complesso se non è vuoto o se una delle condizioni seguenti è vera:
- L'oggetto XMLList contiene un solo elemento XML con contenuto complesso.
- L'oggetto XMLList contiene degli elementi.
Boolean — Se nell'oggetto XMLList è presente un contenuto complesso, viene restituito true; in caso contrario false.
|
Altre informazioni
Elementi API correlati
hasOwnProperty | () | metodo |
AS3 function hasOwnProperty(p:String):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Verifica la presenza della proprietà specificata da p.
Parametri
p:String — La proprietà per cui deve essere trovata la corrispondenza.
|
Boolean — Se il parametro esiste, viene restituito true; in caso contrario false.
|
Altre informazioni
hasSimpleContent | () | metodo |
AS3 function hasSimpleContent():Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Verifica se nell'oggetto XMLList è presente del contenuto semplice. Un oggetto XMLList include un contenuto semplice se una o più delle condizioni seguenti sono vere:
- L'oggetto XMLList è vuoto
- L'oggetto XMLList contiene un solo elemento XML con contenuto semplice
- L'oggetto XMLList non contiene elementi
Boolean — Se nell'oggetto XMLList è presente del contenuto semplice, viene restituito true; in caso contrario false.
|
Altre informazioni
Elementi API correlati
length | () | metodo |
normalize | () | metodo |
AS3 function normalize():XMLList| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, 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.
RestituisceXMLList — L'oggetto XMLList normalizzato.
|
Altre informazioni
parent | () | metodo |
AS3 function parent():Object| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, 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.
Object — Restituisce l'oggetto XML principale.
|
Altre informazioni
processingInstructions | () | metodo |
AS3 function processingInstructions(name:String = "*"):XMLList| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, 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 = "*") |
XMLList — Un oggetto XMLList che contiene le istruzioni di elaborazione per ogni oggetto XML.
|
Altre informazioni
Elementi API correlati
propertyIsEnumerable | () | metodo |
AS3 function propertyIsEnumerable(p:String):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, 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.
|
Boolean — Se è possibile effettuare l'iterazione della proprietà in un'istruzione for..in, viene restituito true; in caso contrario, false.
|
Altre informazioni
text | () | metodo |
AS3 function text():XMLList| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Chiama il metodo text() di ciascun oggetto XML e restituisce un oggetto XMLList che contiene i risultati.
XMLList — Un oggetto XMLList di tutte le proprietà XML dell'oggetto XMLList che rappresentano i nodi di testo XML.
|
Altre informazioni
Elementi API correlati
toString | () | metodo |
AS3 function toString():String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, 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 un 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 un 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, utilizzate il metodo toXMLString().
String — La rappresentazione in formato stringa dell'oggetto XML.
|
Altri esempi
Altre informazioni
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
toString() quando nell'oggetto XML è presente un contenuto semplice:
var test:XML = <type name="Joe">example</type>; trace(test.toString()); //example
toString() quando nell'oggetto XML è presente un 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>
toXMLString | () | metodo |
AS3 function toXMLString():String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, 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.
String — La rappresentazione in formato stringa dell'oggetto XML.
|
Altri esempi
Altre informazioni
Elementi API correlati
valueOf | () | metodo |
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());
}
}
}
}
Tue Jun 12 2018, 02:44 PM Z