XMLList

Pakket	Hoofdniveau
Klasse	public final dynamic class XMLList
Overerving	XMLList Object

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

De klasse XMLList bevat methoden om te werken met een of meer XML-elementen. Een object XMLList kan een of meer XML-objecten of -elementen vertegenwoordigen (inclusief meerdere knooppunten of kenmerken). U kunt dus methoden voor de elementen als groep aanroepen of voor de afzonderlijke elementen in de verzameling.

Wanneer een object XMLList maar één XML-element heeft, kunt u de methoden voor de XML-klasse rechtstreeks op het object XMLList toepassen. In het volgende voorbeeld is example.two een object XMLList met een lengte van 1, zodat u elke XML-methode kunt aanroepen.

 var example2 = <example><two>2</two></example>;

Wanneer u probeert methoden voor de XML-klasse te gebruiken bij een object XMLList met meer dan één XML-object, wordt een uitzondering gegenereerd. Herhaal in plaats daarvan over de verzameling XMLList (met een instructie for each..in bijvoorbeeld) en pas de methoden toe op elk XML-object in de verzameling.

Bekijk de voorbeelden

Verwante API-elementen

XML
for each..in
Namespace
QName

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		XMLList(value:Object) Maakt een nieuw object XMLList.	XMLList
		attribute(attributeName:*):XMLList Hiermee wordt de methode attribute() van elk XML-object aangeroepen en wordt een object XMLList van de resultaten geretourneerd.	XMLList
		attributes():XMLList Hiermee wordt de methode attributes() van elk XML-object aangeroepen en wordt een object XMLList van kenmerken van elk XML-object geretourneerd.	XMLList
		child(propertyName:Object):XMLList Hiermee wordt de methode child() van elk XML-object aangeroepen en wordt een object XMLList geretourneerd dat de resultaten in volgorde bevat.	XMLList
		children():XMLList Roept de methode children() van elk XML-object aan en retourneert een object XMLList dat de resultaten bevat.	XMLList
		comments():XMLList Roept de methode comments() van elk XML-object aan en retourneert een XMLList van opmerkingen.	XMLList
		contains(value:XML):Boolean Controleert of het object XMLList een XML-object bevat dat gelijk is aan de opgegeven parameter value.	XMLList
		copy():XMLList Retourneert een kopie van het opgegeven object XMLList.	XMLList
		descendants(name:Object = *):XMLList Retourneert alle afstammingen (kinderen, kleinkinderen, achterkleinkinderen, enzovoort) van het XML-object die de opgegeven parameter name hebben.	XMLList
		elements(name:Object = *):XMLList Retourneert de methode elements() van elk XML-object.	XMLList
		hasComplexContent():Boolean Controleert of het object XMLList complexe inhoud bevat.	XMLList
		hasOwnProperty(p:String):Boolean Controleert op de eigenschap die door de parameter p wordt opgegeven.	XMLList
		hasSimpleContent():Boolean Controleert of het object XMLList eenvoudige inhoud bevat.	XMLList
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		length():int Retourneert het aantal eigenschappen in het object XMLList.	XMLList
		normalize():XMLList Voegt aangrenzende tekstknooppunten samen in en verwijdert lege tekstknooppunten uit: alle tekstknooppunten in de XMLList, alle XML-objecten in de XMLList en de afstammingen van alle XML-objecten in de XMLList.	XMLList
		parent():Object Retourneert het bovenliggende item van het object XMLList wanneer alle items in het object XMLList hetzelfde bovenliggende item hebben.	XMLList
		processingInstructions(name:String = "*"):XMLList Wanneer een parameter name is opgegeven, worden hiermee alle onderliggende items van het object XMLList opgesomd die verwerkingsinstructies met die naam bevatten.	XMLList
		propertyIsEnumerable(p:String):Boolean Controleert of de eigenschap p voorkomt in de set eigenschappen die kan worden herhaald in een instructie for..in die op het object XMLList wordt toegepast.	XMLList
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		text():XMLList Roept de methode text() van elk XML-object aan en retourneert een object XMLList dat de resultaten bevat.	XMLList
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van alle XML-objecten in een object XMLList.	XMLList
		toXMLString():String Retourneert een tekenreeksrepresentatie van alle XML-objecten in een object XMLList.	XMLList
		valueOf():XMLList Retourneert het object XMLList.	XMLList

Constructordetails

()

Constructor

public function XMLList(value:Object)

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Maakt een nieuw object XMLList.

Parameters

value:Object — Elk object dat kan worden omgezet in een object XMLList met de hoogste functie voor XMLList().

Verwante API-elementen

hoogste functie voor XMLList()

Methodedetails

attribute

()

methode

AS3 function attribute(attributeName:*):XMLList

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Roept de methode attribute() van elk XML-object aan en retourneert een object XMLList van de resultaten. De resultaten komen overeen met de opgegeven parameter attributeName. Wanneer er geen overeenkomst is, wordt met de methode attribute() een leeg object XMLList geretourneerd.

Parameters

attributeName:* — De naam van het kenmerk dat u wilt opnemen in een object XMLList.

Geretourneerde waarde

XMLList — Een object XMLList van overeenkomende XML-objecten of een leeg object XMLList.

Verwante API-elementen

XML.attribute()
XML.attributes()

attributes

()

methode

AS3 function attributes():XMLList

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Roept de methode attributes() van elk XML-object aan en retourneert een object XMLList van kenmerken voor elk XML-object.

Geretourneerde waarde

XMLList — Een object XMLList van kenmerken voor elk XML-object.

Verwante API-elementen

XML.attribute()
XML.attributes()

child

()

methode

AS3 function child(propertyName:Object):XMLList

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Roept de methode child() van elk XML-object aan en retourneert een object XMLList dat de resultaten in volgorde bevat.

Parameters

propertyName:Object — De elementnaam of het gehele getal van het onderliggende XML-item.

Geretourneerde waarde

XMLList — Een object XMLList van onderliggende knooppunten dat overeenkomt met de invoerparameter.

Verwante API-elementen

XML.child()

children

()

methode

AS3 function children():XMLList

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Hiermee wordt de methode children() van elk XML-object aangeroepen en wordt een object XMLList geretourneerd dat de resultaten bevat.

Geretourneerde waarde

XMLList — Een object XMLList van de onderliggende items in de XML-objecten.

Verwante API-elementen

XML.children()

comments

()

methode

AS3 function comments():XMLList

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Roept de methode comments() van elk XML-object aan en retourneert een XMLList van opmerkingen.

Geretourneerde waarde

XMLList — Een XMLList van de opmerkingen in de XML-objecten.

Verwante API-elementen

XML.comments()

contains

()

methode

AS3 function contains(value:XML):Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Hiermee wordt gecontroleerd of het object XMLList een XML-object bevat dat gelijk is aan de opgegeven parameter value.

Parameters

value:XML — Een XML-object dat moet worden vergeleken met het huidige object XMLList.

Geretourneerde waarde

Boolean — true wanneer de XMLList het XML-object bevat dat is gedeclareerd in de parameter value, anders false.

copy

()

methode

AS3 function copy():XMLList

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Retourneert een kopie van het opgegeven object XMLList. De kopie is een duplicaat van de hele boomstructuur met knooppunten. Het gekopieerde XML-object heeft geen bovenliggende items en retourneert null wanneer u de methode parent() probeert aan te roepen.

Geretourneerde waarde

XMLList — De kopie van het object XMLList.

descendants

()

methode

AS3 function descendants(name:Object = *):XMLList

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Retourneert alle afstammingen (kinderen, kleinkinderen, achterkleinkinderen, enzovoort) van het XML-object die de opgegeven parameter name hebben. De parameter name kan een object QName, een gegevenstype String of een ander gegevenstype zijn die vervolgens wordt omgezet in een gegevenstype String.

Wanneer u alle afstammingen wilt retourneren, gebruikt u de parameter asterisk (*). Wanneer geen parameter is doorgegeven, wordt de tekenreeks '*' doorgegeven en worden alle afstammingen van het XML-object geretourneerd.

Parameters

name:Object (default = *) — De naam van het overeen te komen element.

Geretourneerde waarde

XMLList — Een object XMLList van de overeenkomende afstammingen (kinderen, kleinkinderen, enzovoort) van de XML-objecten in de oorspronkelijke lijst. Wanneer er geen afstammingen zijn, wordt een leeg object XMLList geretourneerd.

Verwante API-elementen

XML.descendants()

elements

()

methode

AS3 function elements(name:Object = *):XMLList

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Roept de methode elements() van elk XML-object aan. De parameter name wordt doorgegeven aan de methode descendants(). Wanneer geen parameter wordt doorgegeven, wordt de tekenreeks "*" doorgegeven aan de methode descendants().

Parameters

name:Object (default = *) — De naam van de elementen die moeten overeenkomen.

Geretourneerde waarde

XMLList — Een object XMLList van de overeenkomende onderliggende items van de XML-objecten.

Verwante API-elementen

XML.elements()

hasComplexContent

()

methode

AS3 function hasComplexContent():Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Controleert of het object XMLList complexe inhoud bevat. Een object XMLList wordt geacht complexe inhoud te bevatten wanneer het niet leeg is en een van de volgende voorwaarden true is:

Het object XMLList bevat één XML-item met complexe inhoud.
Het object XMLList bevat elementen.

Geretourneerde waarde

Boolean — true wanneer het object XMLList complexe inhoud bevat, anders false.

Verwante API-elementen

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

hasOwnProperty

()

methode

AS3 function hasOwnProperty(p:String):Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Controleert op de eigenschap die door p wordt opgegeven.

Parameters

p:String — De overeenkomende eigenschap.

Geretourneerde waarde

Boolean — true wanneer de parameter bestaat, anders false.

hasSimpleContent

()

methode

AS3 function hasSimpleContent():Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Controleert of het object XMLList eenvoudige inhoud bevat. Een object XMLList wordt geacht eenvoudige inhoud te bevatten wanneer een van de volgende voorwaarden true is:

Het object XMLList is leeg
Het object XMLList bevat één XML-item met eenvoudige inhoud
Het object XMLList bevat geen elementen

Geretourneerde waarde

Boolean — true wanneer XMLList eenvoudige inhoud bevat, anders false.

Verwante API-elementen

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

length

()

methode

AS3 function length():int

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Retourneert het aantal eigenschappen in het object XMLList.

Geretourneerde waarde

int — Het aantal eigenschappen in het object XMLList.

normalize

()

methode

AS3 function normalize():XMLList

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Voegt aangrenzende tekstknooppunten samen in en verwijdert lege tekstknooppunten uit: alle tekstknooppunten in de XMLList, alle XML-objecten in de XMLList en de afstammingen van alle XML-objecten in de XMLList.

Geretourneerde waarde

XMLList — Het genormaliseerde object XMLList.

parent

()

methode

AS3 function parent():Object

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Retourneert het bovenliggende item van het object XMLList wanneer alle items in het object XMLList hetzelfde bovenliggende item hebben. Wanneer het object XMLList geen bovenliggend item of verschillende bovenliggende items heeft, wordt undefined geretourneerd.

Geretourneerde waarde

Object — Retourneert het bovenliggende XML-object.

processingInstructions

()

methode

AS3 function processingInstructions(name:String = "*"):XMLList

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Wanneer een parameter name is opgegeven, worden hiermee alle onderliggende items van het object XMLList opgesomd die verwerkingsinstructies met die naam bevatten. Wanneer geen parameter is opgegeven, worden alle onderliggende items van het object XMLList opgesomd die verwerkingsinstructies bevatten.

Parameters

name:String (default = "*") — De naam van de overeen te komen verwerkingsinstructies.

Geretourneerde waarde

XMLList — Een object XMLList dat de verwerkingsinstructies bevat voor elk XML-object.

Verwante API-elementen

XML.processingInstructions()

propertyIsEnumerable

()

methode

AS3 function propertyIsEnumerable(p:String):Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Controleert of de eigenschap p voorkomt in de set eigenschappen die kan worden herhaald in een instructie for..in die op het object XMLList wordt toegepast. Dit is alleen true wanneer toNumber(p) groter dan of gelijk is aan 0 en kleiner dan de lengte van het object XMLList.

Parameters

p:String — De index van een eigenschap die wordt gecontroleerd.

Geretourneerde waarde

Boolean — Wanneer de eigenschap kan worden herhaald in een instructie for..in dan true, anders false.

text

()

methode

AS3 function text():XMLList

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Roept de methode text() van elk XML-object aan en retourneert een object XMLList dat de resultaten bevat.

Geretourneerde waarde

XMLList — Een object XMLList van alle XML-eigenschappen van het object XMLList die XML-tekstknooppunten vertegenwoordigen.

Verwante API-elementen

XML.text()

toString

()

methode

AS3 function toString():String

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Retourneert een tekenreeksrepresentatie van alle XML-objecten in een object XMLList. De regels voor deze omzetting hangen af van het feit of het XML-object eenvoudige inhoud of complexe inhoud bevat:

Wanneer het XML-object eenvoudige inhoud bevat, wordt met toString() de tekenreeksinhoud van het XML-object geretourneerd met het volgende verwijderd: starttag, kenmerken, naamruimtedeclaraties en eindtag.

Wanneer het XML-object complexe inhoud bevat, wordt met toString() een tekenreeks met XML-code geretourneerd die het gehele XML-object vertegenwoordigt, inclusief de starttag, kenmerken, naamruimtedeclaraties en eindtag.

Gebruik de methode toXMLString() wanneer u het gehele XML-object telkens wilt retourneren.

Geretourneerde waarde

String — De tekenreeksrepresentatie van het XML-object.

Verwante API-elementen

hasComplexContent()
hasSimpleContent()
toXMLString()

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt getoond wat de methode toString() retourneert wanneer het XML-object eenvoudige inhoud bevat:

var test:XML = <type name="Joe">example</type>;
trace(test.toString()); //example

In het volgende voorbeeld wordt getoond wat de methode toString() retourneert wanneer het XML-object complexe inhoud bevat:

var test:XML = 
<type name="Joe">
    <base name="Bob"></base>
    example
</type>;
trace(test.toString());
  // <type name="Joe">
  // <base name="Bob"/>
  // example
  // </type>

toXMLString

()

methode

AS3 function toXMLString():String

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Retourneert een tekenreeksrepresentatie van alle XML-objecten in een object XMLList. In tegenstelling tot de methode toString(), retourneert de methode toXMLString() altijd de starttag, kenmerken en eindtag van het XML-object, ongeacht of het XML-object eenvoudige inhoud of complexe inhoud bevat. (De methode toString() verwijdert deze items voor XML-objecten die eenvoudige inhoud bevatten.)

Geretourneerde waarde

String — De tekenreeksrepresentatie van het XML-object.

Verwante API-elementen

toString()

valueOf

()

methode

AS3 function valueOf():XMLList

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9

Retourneert het object XMLList.

Geretourneerde waarde

XMLList — Retourneert het huidige object XMLList.

Voorbeelden Hoe dit voorbeeld te gebruiken

XMLListExample.as

In het volgende voorbeeld wordt een XML-eigenschap met de naam books gemaakt en worden diverse items toegevoegd met de tags book publisher en name aan een knooppunt met de naam books. Vervolgens wordt de methode showBooksByPublisher() aangeroepen, die aan de hand van de XMLList de uitgever, "Addison-Wesley", retourneert.

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

Juridische kennisgeving | Online privacybeleid

XMLList - AS3

Pakkettenx

Taalelementen

Bijlagen

Klassen x

XMLList

attribute

attributes

child

children

comments

contains

copy

descendants

elements

hasComplexContent

hasOwnProperty

hasSimpleContent

length

normalize

parent

processingInstructions

propertyIsEnumerable

text

toString

toXMLString

valueOf