PacchettoPrimo livello
Classepublic final dynamic class XMLList
EreditarietàXMLList Inheritance Object

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

Vedere anche

XML
for each..in
Namespace
QName


Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
Metodi pubblici
 MetodoDefinito 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
  
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
  
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 dato.
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
  
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
 Inherited
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
 Inherited
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 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
Descrizione della funzione di costruzione
XMLList()Funzione di costruzione
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

Descrizione dei metodi
attribute()metodo
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

attributes()metodo 
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

child()metodo 
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

children()metodo 
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

comments()metodo 
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

contains()metodo 
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

copy()metodo 
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

descendants()metodo 
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

elements()metodo 
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

hasComplexContent()metodo 
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:

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

Vedere anche

hasOwnProperty()metodo 
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

hasSimpleContent()metodo 
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:

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

Vedere anche

length()metodo 
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

normalize()metodo 
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

parent()metodo 
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

processingInstructions()metodo 
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

propertyIsEnumerable()metodo 
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

text()metodo 
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

toString()metodo 
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:

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> 
toXMLString()metodo 
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

valueOf()metodo 
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

Esempi Come utilizzare gli esempi
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());
            }
        }
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/XMLList.html