Klasa: XML
Kompatybilność: ActionScript 1.0, Flash 5+
Użyj metod oraz właściwości klasy XML, aby wczytać, przetworzyć, wysłać, stworzyć lub manipulować dokument drzewa XML.
Musisz użyć konstruktora new XML(),
aby stworzyć obiekt XML, przed wywołanie metod klasy XML.
Dokument XML jest zaprezentowany we Flash'u przez klasę XML. Każdy element dokumentu hierarchicznego jest zaprezentowany przez obiekt XMLNode.
Po więcej informacji, patrz klasa XMLNode, szeczeólnie: appendChild()
, attributes
, childNodes
, cloneNode()
, firstChild
, hasChildNodes()
, insertBefore()
, lastChild
, nextSibling
, nodeName
, nodeType
, nodeValue
, parentNode
, previousSibling
, removeNode()
, oraz toString()
.
We wcześniejszych wersjach ActionScript, wcześniejsze metody oraz właściwości były dokumentowane w klasie XML, teraz są one udokumentowane w XMLNode.
Wskazówka: Obiekty XML oraz XMLNode są zmodelowane po W3C DOM Level 1 rekomendacji, którą można zobaczyć na http://www.w3.org/tr/1998/REC-DOM-Level-1-19981001/level-one-core.html. Ta rekomendacja określa interfejs Node oraz Document. Interfejs Document dziedziczy od interfejsu Node oraz dodaje metody takie jak createElement()
czy createTextNode()
. W ActionScript, obiekty XML i XMLNode są zaprojektowane, aby podzielić funkcjonalność wzdłóż podbnych linii.
Dostępne właściwości dla klasy XML
Nazwa |
Opis |
---|---|
contentType |
Zawartość typu MIME, która jest wysłana do serwera, kiedy wywołujesz metodę: |
docTypeDecl |
Określa informację o deklaracji DOCTYPE dokumentu XML. |
idMap |
Obiekt zawierający przodki pliku XML, ktore posiadają atrybut |
ignoreWhite |
Domyślnie ustawione na FALSE. |
loaded |
Właściwość, określający, czy dokument XML, został pomyślnie załadowany. |
status |
Automatycznie wysyła oraz zwraca wartość liczbową, która określa, czy dokument XML został poprawnie przetworzony do obiektu XML. |
xmlDecl |
Ciąg znaków, określający informacje o deklaracji dokumentu XML. |
Dostępne zdarzenia dla klasy XML
Zdarzenie |
Opis |
---|---|
onData |
Wywołuje się, gdy tekst XML zostaje pobrany z serwera, lub kiedy wystąpi błąd podczas pobierania z serwera pliku XML. |
onHTTPStatus |
Wywołuje się, gdy Flash Player odbiera kod statusu HTTP od serwera. |
onLoad |
Wywołuje się, gdy Flash Player pobierze dokument XML w całości. |
Dostępne metody dla klasy XML
Nazwa |
Opis |
---|---|
addRequestHeader |
Dodaje lub zmienia wymagane nagłówki HTTP (jak na przykład |
createElement |
Tworzy nowy element XML, z nazwą określoną w parametrze. |
createTextNode |
Tworzy nowy tekstowy przodek XML, określony przez tekst 'wartosc'. |
getBytesLoaded |
Zwraca liczbę bajtów załadowanch (strumieniowo) dla dokumentu XML. |
getBytesTotal |
Zwraca rozmiar, w bajtach,dokumentu XML. |
load |
Wczytuje dokument XML z określonej lokalizacji URL oraz zamienia zawartości określonego obiektu XML z pobranymi danymi XML. |
parseXML |
Przetwarza tekst XML, określony w parametrze 'wartosc', oraz wypełnia określony obiekt XML z wynikowym drzewem XML. |
send |
Zakodowuje określony obiekt XML do dokumentu XML oraz wysyła go na określony adres URL 'cel'. |
sendAndLoad |
Zakodowuje określony obiekt XML do dokumentu XML, wysyła go na określony adres URL używając metody POST, pobiera odpowiedź serwera, oraz wczytuje go do |
Listing
var moj_xml:XML = new XML();
//#2
var inny_xml:XML = new XML("<status nazwa=\"Loading\"><wartosc>Zaladowane</wartosc></status>");