XMLList

Paket	Översta nivån
Klass	public final dynamic class XMLList
Arv	XMLList Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Klassen XMLList innehåller metoder som du använder när du arbetar med ett eller flera XML-element. Ett XMLList-objekt kan representera ett eller flera XML-objekt eller -element (däribland flera noder eller attribut). Du kan därför anropa metoder på elementen som en grupp eller på de individuella elementen i samlingen.

Om ett XMLList-objekt endast har ett XML-element kan du använda XML-klassmetoderna på XMLList-objektet direkt. I följande exempel är example.two ett XMLList-objekt med längden 1, så du kan anropa vilken XML-metod på objektet som du vill.

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

Om du försöker använda XML-klassmetoder med ett XMLList-objekt som innehåller fler än ett XML-objekt, genereras ett undantag. I stället kan du iterera över XMLList-samlingen (med till exempel en for each..in-programsats) och använda metoderna på varje XML-objekt i samlingen.

Visa exemplen

Relaterade API-element

XML
for each..in
Namespace
QName

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		XMLList(value:Object) Skapar ett nytt XMLList-objekt.	XMLList
		attribute(attributeName:*):XMLList Anropar metoden attribute() för varje XML-objekt och returnerar ett XMLList-objekt för resultaten.	XMLList
		attributes():XMLList Anropar metoden attributes() för varje XML-objekt och returnerar ett XMLList-objekt med attribut för varje XML-objekt.	XMLList
		child(propertyName:Object):XMLList Anropar metoden child() för varje XML-objekt och returnerar ett XMLList-objekt som innehåller resultaten i ordning.	XMLList
		children():XMLList Anropar metoden children() för varje XML-objekt och returnerar ett XMLList-objekt som innehåller resultaten.	XMLList
		comments():XMLList Anropar metoden comments() för varje XML-objekt och returnerar ett XMLList-objekt med kommentarer.	XMLList
		contains(value:XML):Boolean Kontrollerar om XMLList-objektet innehåller ett XML-objekt som är lika med den givna value-parametern.	XMLList
		copy():XMLList Returnerar en kopia av det givna XMLList-objektet.	XMLList
		descendants(name:Object = *):XMLList Returnerar alla underordnade objekt (direkt underordnade och indirekt underordnade i ett eller flera steg) för XML-objektet med den givna name-parametern.	XMLList
		elements(name:Object = *):XMLList Anropar metoden elements() i varje XML-objekt.	XMLList
		hasComplexContent():Boolean Kontrollerar om XMLList-objektet innehåller komplext innehåll.	XMLList
		hasOwnProperty(p:String):Boolean Kontrollerar egenskapen som anges av p.	XMLList
		hasSimpleContent():Boolean Kontrollerar om XMLList-objektet innehåller enkelt innehåll.	XMLList
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		length():int Returnerar antalet egenskaper i XMLList-objektet.	XMLList
		normalize():XMLList Sammanfogar angränsande textnoder och eliminerar tomma textnoder för var och en av följande: alla textnoder i XMLList, alla XML-objekt i XMLList och alla underordnade objekt för alla XML-objekt i XMLList.	XMLList
		parent():Object Returnerar XMLList-objektets överordnade objekt om alla element i XMLList-objektet har samma överordnade objekt.	XMLList
		processingInstructions(name:String = "*"):XMLList Om en namnparameter har angetts listas alla underordnade objekt för XMLList-objektet som innehåller behandlingsinstruktioner med det namnet.	XMLList
		propertyIsEnumerable(p:String):Boolean Kontrollerar om egenskapen p finns i egenskapsuppsättningen som kan itereras i en for..in-programsats som tillämpas på XMLList-objektet.	XMLList
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		text():XMLList Anropar metoden text() för varje XML-objekt och returnerar ett XMLList-objekt som innehåller resultaten.	XMLList
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String Returnerar en strängbeteckning för alla XML-objekt i ett XMLList-objekt.	XMLList
		toXMLString():String Returnerar en strängbeteckning för alla XML-objekt i ett XMLList-objekt.	XMLList
		valueOf():XMLList Returnerar XMLList-objektet.	XMLList

Konstruktordetaljer

()

Konstruktor

public function XMLList(value:Object)

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Skapar ett nytt XMLList-objekt.

Parametrar

value:Object — Alla objekt kan konverteras till ett XMLList-objekt genom att använda toppnivåfunktionen XMLList().

Relaterade API-element

XMLList()-funktion på översta nivån

Metoddetaljer

attribute

()

metod

AS3 function attribute(attributeName:*):XMLList

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Anropar metoden attribute() för varje XML-objekt och returnerar ett XMLList-objekt för resultaten. Resultaten matchar den givna parametern attributeName. Om det inte blir någon matchning returnerar metoden attribute() ett tomt XMLList-objekt.

Parametrar

attributeName:* — Attributnamnet som du vill ta med i ett XMLList-objekt.

Returnerar

XMLList — Ett XMLList-objekt som består av matchande XML-objekt eller ett tomt XMLList-objekt.

Relaterade API-element

XML.attribute()
XML.attributes()

attributes

()

metod

AS3 function attributes():XMLList

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Anropar metoden attributes() för varje XML-objekt och returnerar ett XMLList-objekt med attribut för varje XML-objekt.

Returnerar

XMLList — Ett XMLList-objekt med attribut för varje XML-objekt.

Relaterade API-element

XML.attribute()
XML.attributes()

child

()

metod

AS3 function child(propertyName:Object):XMLList

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Anropar metoden child() för varje XML-objekt och returnerar ett XMLList-objekt som innehåller resultaten i ordning.

Parametrar

propertyName:Object — Elementnamnet eller heltalet för det underordnade XML-elementet.

Returnerar

XMLList — Ett XMLList-objekt med underordnade noder som matchar indataparametern.

Relaterade API-element

XML.child()

children

()

metod

AS3 function children():XMLList

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Anropar metoden children() för varje XML-objekt och returnerar ett XMLList-objekt som innehåller resultaten.

Returnerar

XMLList — Ett XMLList-objekt med de underordnade elementen i XML-objekten.

Relaterade API-element

XML.children()

comments

()

metod

AS3 function comments():XMLList

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Anropar metoden comments() för varje XML-objekt och returnerar ett XMLList-objekt med kommentarer.

Returnerar

XMLList — Ett XMLList-objekt med kommentarer i XML-objekten.

Relaterade API-element

XML.comments()

contains

()

metod

AS3 function contains(value:XML):Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Kontrollerar om XMLList-objektet innehåller ett XML-objekt som är lika med den givna value-parametern.

Parametrar

value:XML — Ett XML-objekt som jämförs med det aktuella XMLList-objektet.

Returnerar

Boolean — Om XMLList-objektet innehåller XML-objektet som deklarerades i parametern value returneras true annars returneras false.

copy

()

metod

AS3 function copy():XMLList

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Returnerar en kopia av det givna XMLList-objektet. Kopian är ett duplikat av hela trädet med noder. Det kopierade XML-objektet har inget överordnat objekt och returnerar null om du anropar metoden parent().

Returnerar

XMLList — Kopian av XMLList-objektet.

descendants

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Returnerar alla underordnade objekt (direkt underordnade och indirekt underordnade i ett eller flera steg) för XML-objektet med den givna name-parametern. Parametern name kan vara ett QName-objekt, en String-datatyp eller någon annan datatyp som konverteras till en String-datatyp.

Om du vill returnera alla underordnade objekt använder du parametern asterisk (*). Om ingen parameter skickas, skickas strängen "*" och alla underordnade objekt till XML-objektet returneras.

Parametrar

name:Object (default = *) — Namnet på elementet som ska matchas.

Returnerar

XMLList — Ett XMLList-objekt med matchande underordnade objekt (direkt underordnade och indirekt underordnade i ett eller flera steg) till XML-objekten i den ursprungliga listan. Om det inte finns några underordnade objekt returneras ett tomt XMLList-objekt.

Relaterade API-element

XML.descendants()

elements

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Anropar metoden elements() i varje XML-objekt. Parametern name skickas till metoden descendants(). Om ingen parameter skickas, skickas strängen "*" till metoden descendants().

Parametrar

name:Object (default = *) — Namnet på elementen som ska matchas.

Returnerar

XMLList — Ett XMLList-objekt med de matchande underordnade elementen i XML-objekten.

Relaterade API-element

XML.elements()

hasComplexContent

()

metod

AS3 function hasComplexContent():Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Kontrollerar om XMLList-objektet innehåller komplext innehåll. Ett XMLList-objekt anses innehålla komplext innehåll om det inte är tomt och något av följande villkor är uppfyllda:

XMLList-objektet innehåller ett enstaka XML-objekt med komplext innehåll.
XMLList-objektet innehåller element.

Returnerar

Boolean — Om XMLList-objektet innehåller komplext innehåll true; annars false.

Relaterade API-element

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

hasOwnProperty

()

metod

AS3 function hasOwnProperty(p:String):Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Kontrollerar egenskapen som anges av p.

Parametrar

p:String — Egenskapen som ska matchas.

Returnerar

Boolean — Om parametern existerar true; annars false.

hasSimpleContent

()

metod

AS3 function hasSimpleContent():Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Kontrollerar om XMLList-objektet innehåller enkelt innehåll. Ett XMLList-objekt anses innehålla enkelt innehåll om ett eller flera av följande villkor är uppfyllda:

XMLList-objektet är tomt
XMLList-objektet innehåller ett enstaka XML-objekt med enkelt innehåll
XMLList-objektet innehåller inga element

Returnerar

Boolean — Om XMLList-objektet innehåller enkelt innehåll true; annars false.

Relaterade API-element

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

length

()

metod

AS3 function length():int

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Returnerar antalet egenskaper i XMLList-objektet.

Returnerar

int — Antalet egenskaper i XMLList-objektet.

normalize

()

metod

AS3 function normalize():XMLList

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Sammanfogar angränsande textnoder och eliminerar tomma textnoder för var och en av följande: alla textnoder i XMLList, alla XML-objekt i XMLList och alla underordnade objekt för alla XML-objekt i XMLList.

Returnerar

XMLList — Det normaliserade XMLList-objektet.

parent

()

metod

AS3 function parent():Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Returnerar XMLList-objektets överordnade objekt om alla element i XMLList-objektet har samma överordnade objekt. Om XMLList-objektet inte har något överordnat objekt eller olika överordnade objekt returnerar metoden undefined.

Returnerar

Object — Returnerar det överordnade XML-objektet.

processingInstructions

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Om en name-parameter har angetts listas alla underordnade objekt för XMLList-objektet som innehåller behandlingsinstruktioner med det namnet. Utan parametrar listar metoden alla underordnade objekt för XMLList-objektet som innehåller behandlingsinstruktioner.

Parametrar

name:String (default = "*") — Namnet på behandlingsinstruktionerna som ska matchas.

Returnerar

XMLList — Ett XMLList-objekt som innehåller behandlingsinstruktionerna för varje XML-objekt.

Relaterade API-element

XML.processingInstructions()

propertyIsEnumerable

()

metod

AS3 function propertyIsEnumerable(p:String):Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Kontrollerar om egenskapen p finns i egenskapsuppsättningen som kan itereras i en for..in-programsats som tillämpas på XMLList-objektet. Detta är endast true om toNumber(p) är större än eller lika med 0 och kortare än längden på XMLList-objektet.

Parametrar

p:String — Indexvärdet för egenskapen som ska kontrolleras.

Returnerar

Boolean — Om egenskapen kan itereras i en for..in-programsats true; annars false.

text

()

metod

AS3 function text():XMLList

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Anropar metoden text() för varje XML-objekt och returnerar ett XMLList-objekt som innehåller resultaten.

Returnerar

XMLList — Ett XMLList-objekt för alla XML-egenskaper för XMLList-objektet som representerar XML-textnoder.

Relaterade API-element

XML.text()

toString

()

metod

AS3 function toString():String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Returnerar en strängbeteckning för alla XML-objekt i ett XMLList-objekt. Reglerna för denna konvertering beror på om XML-objektet har enkelt eller komplext innehåll:

Om XML-objektet har enkelt innehåll returnerar toString() stränginnehållet för XML-objektet utan följande borttaget: starttaggen, attribut, namnutrymmesdeklarationer och sluttaggen.

Om XML-objektet har komplext innehåll returnerar toString() en XML-kodad sträng som representerar hela XML-objektet, inklusive starttagg, attribut, namnutrymmesdeklarationer och sluttagg.

Om du vill att hela XML-objektet ska returneras varje gång använder du metoden toXMLString().

Returnerar

String — XML-objektets strängbeteckning.

Relaterade API-element

hasComplexContent()
hasSimpleContent()
toXMLString()

Exempel ( Så här använder du exemplet )

I följande exempel visas vad metoden toString() returnerar när XML-objektet har enkelt innehåll:

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

I följande exempel visas vad metoden toString() returnerar när XML-objektet har komplext innehåll:

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

toXMLString

()

metod

AS3 function toXMLString():String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Returnerar en strängbeteckning för alla XML-objekt i ett XMLList-objekt. Till skillnad från metoden toString() returnerar alltid metoden toXMLString() starttaggen, attribut och sluttaggen för XML-objektet, oavsett om XML-objektet har enkelt eller komplext innehåll. (Metoden toString() tar bort dessa objekt för XML-objekt som innehåller enkelt innehåll.)

Returnerar

String — XML-objektets strängbeteckning.

Relaterade API-element

toString()

valueOf

()

metod

AS3 function valueOf():XMLList

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

Returnerar XMLList-objektet.

Returnerar

XMLList — Returnerar aktuellt XMLList-objektet.

Exempel Så här använder du exemplet

XMLListExample.as

I följande exempel skapas en XML-egenskap med namnet books och flera poster med taggarna book publisher och name läggs till i en nod med namnet books. Därefter anropas metoden showBooksByPublisher(). Metoden tar XMLList och returnerar alla poster som matchar utgivaren (book publisher) "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());
            }
        }
    }
}

Juridiska meddelanden | Onlinesekretesspolicy

XMLList - AS3

Klasser x

XMLList

attribute

attributes

child

children

comments

contains

copy

descendants

elements

hasComplexContent

hasOwnProperty

hasSimpleContent

length

normalize

parent

processingInstructions

propertyIsEnumerable

text

toString

toXMLString

valueOf