XMLList

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

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 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.

Vedere gli esempi

Altri esempi

Inizializzazione delle variabili XML
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

Operazioni con XML
Nozioni di base su XML
L'approccio E4X all'elaborazione XML
Oggetti XML
Oggetti XMLList

Elementi API correlati

XML
for each..in
Namespace
QName

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		XMLList(value:Object) Crea un nuovo oggetto XMLList.	XMLList
		attribute(attributeName:*):XMLList Chiama il metodo attribute() di ciascun oggetto XML e restituisce un oggetto XMLList dei risultati.	XMLList
		attributes():XMLList Chiama il metodo attributes() di ciascun oggetto XML e restituisce un oggetto XMLList di attributi per ogni oggetto XML.	XMLList
		child(propertyName:Object):XMLList Chiama il metodo child() di ciascun oggetto XML e restituisce un oggetto XMLList che contiene i risultati in ordine.	XMLList
		children():XMLList Chiama il metodo children() di ciascun oggetto XML e restituisce un oggetto XMLList che contiene i risultati.	XMLList
		comments():XMLList Chiama il metodo comments() di ciascun oggetto XML e restituisce un oggetto XMLList di commenti.	XMLList
		contains(value:XML):Boolean Verifica se l'oggetto XMLList contiene un oggetto XML uguale al parametro value dato.	XMLList
		copy():XMLList Restituisce una copia dell'oggetto XMLList specifico.	XMLList
		descendants(name:Object = *):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
		elements(name:Object = *):XMLList Chiama il metodo elements() di ogni oggetto XML.	XMLList
		hasComplexContent():Boolean Verifica se nell'oggetto XMLList è presente del contenuto complesso.	XMLList
		hasOwnProperty(p:String):Boolean Verifica la presenza della proprietà specificata da p.	XMLList
		hasSimpleContent():Boolean Verifica se nell'oggetto XMLList è presente del contenuto semplice.	XMLList
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		length():int Restituisce il numero di proprietà nell'oggetto XMLList.	XMLList
		normalize():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
		parent():Object Restituisce l'elemento principale dell'oggetto XMLList se tutti gli elementi nell'oggetto XMLList hanno lo stesso elemento principale.	XMLList
		processingInstructions(name:String = "*"):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
		propertyIsEnumerable(p:String):Boolean 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
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		text():XMLList Chiama il metodo text() di ciascun oggetto XML e restituisce un oggetto XMLList che contiene i risultati.	XMLList
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce una rappresentazione in formato stringa di tutti gli oggetti XML in un oggetto XMLList.	XMLList
		toXMLString():String Restituisce una rappresentazione in formato stringa di tutti gli oggetti XML in un oggetto XMLList.	XMLList
		valueOf():XMLList Restituisce l'oggetto XMLList.	XMLList

Descrizione della funzione di costruzione

()

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.

Parametri

value:Object — Qualunque oggetto che può essere convertito in un oggetto XMLList utilizzando la funzione XMLList() di primo livello.

Elementi API correlati

Funzione XMLList() di primo livello

Descrizione dei metodi

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.

Restituisce

XMLList — Un oggetto XMLList di oggetti XML corrispondenti o un oggetto XMLList vuoto.

Altre informazioni

Oggetti XMLList

Elementi API correlati

XML.attribute()
XML.attributes()

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.

Restituisce

XMLList — Un oggetto XMLList di attributi per ogni oggetto XML.

Altre informazioni

Oggetti XMLList

Elementi API correlati

XML.attribute()
XML.attributes()

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.

Restituisce

XMLList — Un oggetto XMLList di nodi secondari che corrispondono al parametro di input.

Altre informazioni

Oggetti XMLList

Elementi API correlati

XML.child()

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.

Restituisce

XMLList — Un oggetto XMLList degli elementi secondari negli oggetti XML.

Altre informazioni

Oggetti XMLList

Elementi API correlati

XML.children()

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.

Restituisce

XMLList — Un oggetto XMLList dei commenti negli oggetti XML.

Altre informazioni

Oggetti XMLList

Elementi API correlati

XML.comments()

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.

Restituisce

Boolean — Se l'oggetto XMLList contiene l'oggetto XML dichiarato nel parametro value, viene restituito true; in caso contrario, false.

Altre informazioni

Oggetti XMLList

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

Restituisce

XMLList — Una copia dell'oggetto XMLList.

Altre informazioni

Oggetti XMLList

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 = *) — 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.

Altre informazioni

Oggetti XMLList

Elementi API correlati

XML.descendants()

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 = *) — Il nome degli elementi per cui deve essere cercata una corrispondenza.

Restituisce

XMLList — Un oggetto XMLList degli elementi secondari corrispondenti negli oggetti XML.

Elementi API correlati

XML.elements()

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.

Restituisce

Boolean — Se nell'oggetto XMLList è presente un contenuto complesso, viene restituito true; in caso contrario false.

Altre informazioni

Oggetti XMLList

Elementi API correlati

hasSimpleContent()
XML.hasComplexContent()
XML.hasSimpleContent()

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.

Restituisce

Boolean — Se il parametro esiste, viene restituito true; in caso contrario false.

Altre informazioni

Oggetti XMLList

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

Restituisce

Boolean — Se nell'oggetto XMLList è presente del contenuto semplice, viene restituito true; in caso contrario false.

Altre informazioni

Oggetti XMLList

Elementi API correlati

hasComplexContent()
XML.hasComplexContent()
XML.hasSimpleContent()

length

()

metodo

AS3 function length():int

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9

Restituisce il numero di proprietà nell'oggetto XMLList.

Restituisce

int — Il numero di proprietà nell'oggetto XMLList.

Altre informazioni

Oggetti XMLList

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.

Restituisce

XMLList — L'oggetto XMLList normalizzato.

Altre informazioni

Oggetti XMLList

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.

Restituisce

Object — Restituisce l'oggetto XML principale.

Altre informazioni

Oggetti XMLList

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 = "*") — 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.

Altre informazioni

Oggetti XMLList

Elementi API correlati

XML.processingInstructions()

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.

Restituisce

Boolean — Se è possibile effettuare l'iterazione della proprietà in un'istruzione for..in, viene restituito true; in caso contrario, false.

Altre informazioni

Oggetti XMLList

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.

Restituisce

XMLList — Un oggetto XMLList di tutte le proprietà XML dell'oggetto XMLList che rappresentano i nodi di testo XML.

Altre informazioni

Oggetti XMLList

Elementi API correlati

XML.text()

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

Restituisce

String — La rappresentazione in formato stringa dell'oggetto XML.

Altri esempi

Conversione degli oggetti XML

Altre informazioni

Oggetti XMLList

Elementi API correlati

hasComplexContent()
hasSimpleContent()
toXMLString()

Esempio ( Come utilizzare questo esempio )

L'esempio seguente mostra il risultato del metodo toString() quando nell'oggetto XML è presente un 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 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.

Restituisce

String — La rappresentazione in formato stringa dell'oggetto XML.

Altri esempi

Conversione degli oggetti XML

Altre informazioni

Oggetti XMLList

Elementi API correlati

toString()

valueOf

()

metodo

AS3 function valueOf():XMLList

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9

Restituisce l'oggetto XMLList.

Restituisce

XMLList — Restituisce l'oggetto XMLList corrente.

Altre informazioni

Oggetti XMLList

Esempi Come utilizzare questo esempio

XMLListExample.as

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

Note legali | Informativa sulla privacy online

XMLList - AS3

Pacchettix

Elementi del linguaggio

Appendici

Classi x

XMLList

attribute

attributes

child

children

comments

contains

copy

descendants

elements

hasComplexContent

hasOwnProperty

hasSimpleContent

length

normalize

parent

processingInstructions

propertyIsEnumerable

text

toString

toXMLString

valueOf