XMLList

Pakiet	Najwyższy poziom
Klasa	public final dynamic class XMLList
Dziedziczenie	XMLList Object

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Klasa XMLList zawiera metody służące do pracy z elementami XML. Obiekt XMLList może reprezentować przynajmniej jeden obiekt XML lub element (wraz z wieloma węzłami lub atrybutami), dlatego metody można wywoływać dla elementów jako grupy lub dla poszczególnych elementów kolekcji.

Jeśli obiekt XMLList posiada tylko jeden element XML, można bezpośrednio zastosować metodę klasy XML do obiektu XMLList. W poniższym przykładzie, obiekt example.two stanowi obiekt XMLList o długości równej 1, więc można dla niego wywołać dowolną metodę XML.

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

W przypadku użycia metod klasy XML dla obiektów XMLList zawierających więcej niż jeden obiekt XML, generowany jest wyjątek. Dlatego należy iterować kolekcję XMLList (na przykład za pomocą instrukcji for each..in) i zastosować metodę do wszystkich obiektów XML w kolekcji.

Wyświetl przykłady

Powiązane elementy interfejsu API

XML
for each..w
Przestrzeń nazw
QName

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		XMLList(value:Object) Tworzy nowy obiekt XMLList.	XMLList
		attribute(attributeName:*):XMLList Wywołuje metodę attribute() dla poszczególnych obiektów XML i zwraca wyniki w postaci obiektu XMLList.	XMLList
		attributes():XMLList Wywołuje metodę attributes() dla poszczególnych obiektów XML i zwraca obiekt XMLList z atrybutami poszczególnych obiektów XML.	XMLList
		child(propertyName:Object):XMLList Wywołuje metodę child() dla poszczególnych obiektów XML i zwraca uporządkowaną listę wyników w postaci obiektu XMLList.	XMLList
		children():XMLList Wywołuje metodę children() dla poszczególnych obiektów XML i zwraca wyniki w postaci obiektu XMLList.	XMLList
		comments():XMLList Wywołuje metodę comments() dla poszczególnych obiektów XML i zwraca listę komentarzy w postaci obiektu XMLList.	XMLList
		contains(value:XML):Boolean Sprawdza, czy obiekt XMLList zawiera obiekt XML tożsamy z wartością parametru.	XMLList
		copy():XMLList Zwraca kopię danego obiektu XMLList.	XMLList
		descendants(name:Object = *):XMLList Zwraca wszystkie elementy potomne (bezpośrednio potomne, potomne wobec obiektów potomnych itd.) obiektu XML o danym parametrze name.	XMLList
		elements(name:Object = *):XMLList Wywołuje metodę elements() dla poszczególnych obiektów XML.	XMLList
		hasComplexContent():Boolean Sprawdza, czy obiekt XMLList zawiera elementy złożone.	XMLList
		hasOwnProperty(p:String):Boolean Sprawdza właściwość p.	XMLList
		hasSimpleContent():Boolean Sprawdza, czy obiekt XMLList zawiera elementy proste.	XMLList
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		length():int Zwraca liczbę właściwości obiektu XMLList.	XMLList
		normalize():XMLList Scala sąsiadujące ze sobą węzły tekstowe oraz eliminuje puste węzły tekstowe. Operacje te dotyczą następujących obiektów: wszystkie węzły tekstowe z listy XMLList, wszystkie obiekty XML z listy XMLList, wszystkie obiekty potomne wszystkich obiektów XML z listy XMLList.	XMLList
		parent():Object Zwraca obiekt nadrzędny obiektu XMLList, o ile elementy obiektu XMLList mają ten sam obiekt nadrzędny.	XMLList
		processingInstructions(name:String = "*"):XMLList W przypadku dostarczenia parametru nazwy zwraca listę wszystkich potomków obiektu XMLList, które zawierają instrukcje związane z podaną nazwą.	XMLList
		propertyIsEnumerable(p:String):Boolean Sprawdza, czy właściwość p stanowi zbiór właściwości, które można iterować za pomocą instrukcji for..in zastosowanej do obiektu XMLList.	XMLList
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		text():XMLList Wywołuje metodę text() dla poszczególnych obiektów XML i zwraca wyniki w postaci obiektu XMLList.	XMLList
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg znaków reprezentujący wszystkie obiekty XML wewnątrz obiektu XMLList.	XMLList
		toXMLString():String Zwraca ciąg znaków reprezentujący wszystkie obiekty XML wewnątrz obiektu XMLList.	XMLList
		valueOf():XMLList Zwraca obiekt XMLList.	XMLList

Konstruktor Szczegół

()

Konstruktor

public function XMLList(value:Object)

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Tworzy nowy obiekt XMLList.

Parametry

value:Object — Każdy obiekt, który można konwertować na obiekt XMLList za pomocą funkcji najwyższego poziomu XMLList().

Powiązane elementy interfejsu API

funkcja top-level XMLList()

Szczegół metody

attribute

()

metoda

AS3 function attribute(attributeName:*):XMLList

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Wywołuje metodę attribute() poszczególnych obiektów XML i zwraca wyniki w postaci obiektu XMLList. Wyniki są zgodne z określonym parametrem attributeName. W przypadku braku zgodności metoda attribute() zwraca pusty obiekt XMLList.

Parametry

attributeName:* — Nazwa atrybutu, który ma zostać uwzględniony w obiekcie XMLList.

Zwraca

XMLList — Obiekt XMLList zawierający zgodne obiekty XML lub pusty obiekt XMLList.

Powiązane elementy interfejsu API

XML.attribute()
XML.attributes()

attributes

()

metoda

AS3 function attributes():XMLList

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Wywołuje metodę attributes() dla poszczególnych obiektów XML i zwraca obiekt XMLList z atrybutami poszczególnych obiektów XML

Zwraca

XMLList — Obiekt XMLList zawierający atrybuty dla każdego obiektu XML.

Powiązane elementy interfejsu API

XML.attribute()
XML.attributes()

child

()

metoda

AS3 function child(propertyName:Object):XMLList

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Wywołuje metodę child() dla poszczególnych obiektów XML i zwraca uporządkowaną listę wyników w postaci obiektu XMLList.

Parametry

propertyName:Object — Nazwa elementu lub liczba całkowita podrzędnego obiektu XML.

Zwraca

XMLList — Obiekt XMLList zawierający węzły podrzędne zgodne z parametrem wejściowym.

Powiązane elementy interfejsu API

XML.child()

children

()

metoda

AS3 function children():XMLList

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Wywołuje metodę children() dla poszczególnych obiektów XML i zwraca wyniki w postaci obiektu XMLList.

Zwraca

XMLList — Obiekt XMLList zawierający elementy podrzędne w postaci obiektów XML.

Powiązane elementy interfejsu API

XML.children()

comments

()

metoda

AS3 function comments():XMLList

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Wywołuje metodę comments() dla poszczególnych obiektów XML i zwraca komentarze w postaci obiektu XMLList.

Zwraca

XMLList — Obiekt XMLList zawierający komentarze w postaci obiektów XML.

Powiązane elementy interfejsu API

XML.comments()

contains

()

metoda

AS3 function contains(value:XML):Boolean

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Sprawcza, czy obiekt XMLList zawiera obiekt XML, który jest równy określonemu parametrowi value.

Parametry

value:XML — Obiekt XML, który zostanie porównany z aktualnym obiektem XMLList.

Zwraca

Boolean — Jeśli obiekt XMLList zawiera obiekt XML zadeklarowany przez parametr value, wówczas jego wartością będzie wartość true; w przeciwnym razie, jego wartością będzie wartość false.

copy

()

metoda

AS3 function copy():XMLList

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Zwraca kopię danego obiektu XMLList. Kopia stanowi duplikat wszystkich trzech węzłów. Jeśli skopiowany obiekt XML nie posiada elementu nadrzędnego, wówczas w przypadku wywołania metody parent() zwrócona zostanie wartość będzie null.

Zwraca

XMLList — Kopia obiektu XMLList.

descendants

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Zwraca wszystkie elementy podrzędne (bezpośrednio podrzędne, podrzędne wobec obiektów podrzędnych itd.) obiektu XML o danym parametrze name. Parametr name może stanowić obiekt QName, dane typu String lub inny typ danych, który będzie konwertowany na dane typu String.

Aby uzyskać zwrot wszystkich obiektów potomnych, należy użyć parametru gwiazdki (*). Jeśli żaden parametr nie zostanie przekazany, wówczas przekazany zostaje ciąg „*”, w przypadku którego zwracane są wszystkie elementy potomne obiektu XML.

Parametry

name:Object (default = *) — Nazwa zgodnego elementu.

Zwraca

XMLList — Obiekt XMLList zawierający zgodne elementy podrzędne (bezpośrednio podrzędne, podrzędne wobec obiektów podrzędnych itd.) obiektu XML w postaci oryginalnej listy. W przypadku braku obiektów potomnych zwrócony obiekt XMLList jest pusty.

Powiązane elementy interfejsu API

XML.descendants()

elements

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Wywołuje metodę elements() dla poszczególnych obiektów XML. Parametr name zostaje przekazany do metody descendants(). Jeśli żaden parametr nie zostanie przekazany, wówczas do metody descendants() zostaje przekazany ciąg „*”.

Parametry

name:Object (default = *) — Nazwa zgodnych elementów.

Zwraca

XMLList — Obiekt XMLList zawierający elementy podrzędne obiektu XML.

Powiązane elementy interfejsu API

XML.elements()

hasComplexContent

()

metoda

AS3 function hasComplexContent():Boolean

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Sprawdza, czy obiekt XMLList zawiera elementy złożone. Zakłada się, że obiekt XMLList zawiera elementy złożone, jeśli obiekt nie jest pusty i spełniony jest jeden z poniższych warunków:

Obiekt zawiera XMLList pojedynczy element XML składający się z elementów złożonych.
Obiekt XMLList zawiera wiele elementów.

Zwraca

Boolean — Jeśli obiekt XMLList zawiera elementy złożone, wówczas przyjęta wartość to true; w odwrotnym przypadku — false.

Powiązane elementy interfejsu API

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

hasOwnProperty

()

metoda

AS3 function hasOwnProperty(p:String):Boolean

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Sprawdza właściwość p.

Parametry

p:String — Właściwość do porównania.

Zwraca

Boolean — Jeśli parametr istnieje, wówczas przyjęta wartość to true; w odwrotnym przypadku — false.

hasSimpleContent

()

metoda

AS3 function hasSimpleContent():Boolean

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Sprawdza, czy obiekt XMLList zawiera elementy proste. Zakłada się, że obiekt XMLList zawiera elementy proste, jeśli przynajmniej jeden z poniższych warunków jest spełniony:

Obiekt XMLList jest pusty.
Obiekt XMLList zawiera pojedynczy element XML składający się z prostych elementów.
Obiekt XMLList nie zawiera żadnych elementów.

Zwraca

Boolean — Jeśli obiekt XMLList zawiera elementy proste, wówczas przyjęta wartość to wartość true; w odwrotnym przypadku — wartośćfalse.

Powiązane elementy interfejsu API

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

length

()

metoda

AS3 function length():int

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Zwraca liczbę właściwości obiektu XMLList.

Zwraca

int — Liczba właściwości obiektu XMLList.

normalize

()

metoda

AS3 function normalize():XMLList

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Scala sąsiadujące ze sobą węzły tekstowe oraz eliminuje puste węzły tekstowe. Operacje te dotyczą następujących obiektów: wszystkie węzły tekstowe z listy XMLList, wszystkie obiekty XML z listy XMLList, wszystkie obiekty podrzędne wszystkich obiektów XML z listy XMLList.

Zwraca

XMLList — Znormalizowany obiekt XMLList.

parent

()

metoda

AS3 function parent():Object

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Zwraca obiekt macierzysty obiektu XMLList, o ile elementy obiektu XMLList mają ten sam obiekt macierzysty. Jeśli obiekt XMLList nie posiada elementów macierzystych, metoda zwraca wartość undefined.

Zwraca

Object — Zwraca nadrzędny obiekt XML.

processingInstructions

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

W przypadku dostarczenia parametru name zwraca listę wszystkich obiektów podrzędnych obiektu XMLList, które zawierają instrukcje związane z podaną nazwą. W przypadku braku parametrów, metoda zwraca listę wszystkich obiektów podrzędnych obiektu XMLList, które zawierają dowolne instrukcje.

Parametry

name:String (default = "*") — Nazwa zgodnych instrukcji.

Zwraca

XMLList — Obiekt XMLList zawierający instrukcje dla poszczególnych obiektów XML.

Powiązane elementy interfejsu API

XML.processingInstructions()

propertyIsEnumerable

()

metoda

AS3 function propertyIsEnumerable(p:String):Boolean

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Sprawdza, czy właściwość p stanowi zbiór właściwości, które można iterować za pomocą instrukcji for..in zastosowanej do obiektu XMLList. Wartość true zostaje przyjęta tylko wówczas, gdy parametr toNumber(p) jest większy lub równy 0, a jednocześnie mniejszy od długości obiektu XMLList.

Parametry

p:String — Indeks właściwości, która będzie sprawdzana.

Zwraca

Boolean — Jeśli właściwość można iterować za pomocą instrukcji for..in, wówczas wartością przyjętą jest wartość true; w odwrotnym przypadku — false.

text

()

metoda

AS3 function text():XMLList

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Wywołuje metodę text() dla poszczególnych obiektów XML i zwraca wyniki w postaci obiektu XMLList.

Zwraca

XMLList — Obiekt XMLList zawierający wszystkie właściwości XML obiektu XMLList, które reprezentują węzły tekstowe XML.

Powiązane elementy interfejsu API

XML.text()

toString

()

metoda

AS3 function toString():String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Zwraca ciąg znaków reprezentujący wszystkie obiekty XML wewnątrz obiektu XMLList. Reguły tej konwersji zależą od tego, czy elementy zawarte w obiekcie XML są proste czy złożone:

Jeśli obiekt XML zawiera treść prostą, metoda toString() zwraca zawartość obiektu XML w postaci ciągu znaków i usuwa następujące elementy: znacznik początkowy, atrybuty, deklaracje przestrzeni nazw oraz znacznik końcowy.

Jeśli obiekt XML zawiera elementy złożone, metoda toString() zwraca zakodowany ciąg XML reprezentujący cały obiekt XML, wraz z znacznikiem początkowym, atrybutami, deklaracjami przestrzeni nazw oraz znacznikiem końcowym.

Aby każdym razem zwrot dotyczył całego obiektu XML, należy użyć metody toXMLString().

Zwraca

String — Ciąg znaków reprezentujący obiekt XML.

Powiązane elementy interfejsu API

hasComplexContent()
hasSimpleContent()
toXMLString()

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje wyniki zwrócone przez metodę toString() w przypadku obiektu XML zawierającego elementy proste:

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

Poniższy przykład ilustruje wyniki zwrócone przez metodę toString() w przypadku obiektu XML zawierającego elementy złożone:

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

toXMLString

()

metoda

AS3 function toXMLString():String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Zwraca ciąg znaków reprezentujący wszystkie obiekty XML wewnątrz obiektu XMLList. W przeciwieństwie do metody toString(), metoda toXMLString() zawsze zwraca znacznik początkowy, atrybuty oraz znacznik końcowy obiektu XML bez względu na to, czy elementy zawarte w obiekcie XML są proste czy złożone. (Metoda toString() usuwa te elementy z obiektów XML, które zawierają treść prostą).

Zwraca

String — Ciąg znaków reprezentujący obiekt XML.

Powiązane elementy interfejsu API

toString()

valueOf

()

metoda

AS3 function valueOf():XMLList

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9

Zwraca obiekt XMLList.

Zwraca

XMLList — Zwraca bieżący obiekt XMLList.

Przykłady Sposób korzystania z tego przykładu

XMLListExample.as

Poniższy przykład ilustruje utworzenie właściwości XML o nazwie books i dodanie kilku elementów znaczników book publisher oraz name do węzła o nazwie books. Następnie wywołana metoda showBooksByPublisher() pobiera obiekt XMLList i zwraca każdy element zgodny z wydawcą „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());
            }
        }
    }
}

Informacje prawne | Zasady prywatności online

XMLList - AS3

Klasy x

XMLList

attribute

attributes

child

children

comments

contains

copy

descendants

elements

hasComplexContent

hasOwnProperty

hasSimpleContent

length

normalize

parent

processingInstructions

propertyIsEnumerable

text

toString

toXMLString

valueOf