| Pakket | flash.xml |
| Klasse | public class XMLNode |
| Overerving | XMLNode  Object |
| Subklassen | XMLDocument |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Verwante API-elementen
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergeven| Eigenschap | Gedefinieerd door | ||
|---|---|---|---|
| attributes : Object
Object dat alle kenmerken bevat van de opgegeven instantie XMLNode. | XMLNode | ||
| childNodes : Array [alleen-lezen]
Een array van de opgegeven onderliggende items van het object XMLNode. | XMLNode | ||
 | constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | |
| firstChild : XMLNode
Evalueert het opgegeven object XMLDocument en verwijst naar het eerste item in de lijst met onderliggende items van het bovenliggende knooppunt. | XMLNode | ||
| lastChild : XMLNode
Een XMLNode-waarde die verwijst naar het laatste item in de lijst met onderliggende items van dit knooppunt. | XMLNode | ||
| localName : String [alleen-lezen]
Het gedeelte met de lokale naam van het XML-knooppunt. | XMLNode | ||
| namespaceURI : String [alleen-lezen]
Wanneer het XML-knooppunt een voorvoegsel bevat, is namespaceURI de waarde van de declaratie xmlns voor dat voorvoegsel (de URI) die doorgaans de naamruimte-URI wordt genoemd. | XMLNode | ||
| nextSibling : XMLNode
Een XMLNode-waarde die verwijst naar het volgende item op hetzelfde niveau in de lijst met onderliggende items van het bovenliggende knooppunt. | XMLNode | ||
| nodeName : String
Tekenreeks die de knooppuntnaam van het object XMLNode vertegenwoordigt. | XMLNode | ||
| nodeType : uint
Constante waarde voor nodeType: XMLNodeType.ELEMENT_NODE voor een XML-element of XMLNodeType.TEXT_NODE voor een tekstknooppunt | XMLNode | ||
| nodeValue : String
De knooppuntwaarde van het object XMLDocument. | XMLNode | ||
| parentNode : XMLNode
Een XMLNode-waarde die verwijst naar het bovenliggende knooppunt van het opgegeven XML-object of die leeg retourneert wanneer het knooppunt geen bovenliggend item heeft | XMLNode | ||
| prefix : String [alleen-lezen]
Het gedeelte met het voorvoegsel van de naam van het XML-knooppunt. | XMLNode | ||
| previousSibling : XMLNode
Een XMLNode-waarde die verwijst naar het vorige item op hetzelfde niveau in de lijst met onderliggende items van het bovenliggende knooppunt. | XMLNode | ||
| Methode | Gedefinieerd door | ||
|---|---|---|---|
Maakt een nieuw object XMLNode. | XMLNode | ||
Voegt het opgegeven knooppunt toe aan de lijst met onderliggende items van het object XML. | XMLNode | ||
Vormt en retourneert een nieuw XML-knooppunt van hetzelfde type en met dezelfde naam, waarde en kenmerken als het opgegeven object XML. | XMLNode | ||
Retourneert de naamruimte-URI die aan het opgegeven voorvoegsel voor het knooppunt is gekoppeld. | XMLNode | ||
Retourneert het voorvoegsel dat aan de opgegeven naamruimte-URI voor het knooppunt is gekoppeld. | XMLNode | ||
Geeft aan of het opgegeven object XMLNode onderliggende knooppunten bevat. | XMLNode | ||
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
Voegt een nieuw onderliggend knooppunt toe in de lijst met onderliggende items van het object XML voor het knooppunt beforeNode. | XMLNode | ||
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
Verwijdert het opgegeven object XML uit het bovenliggende item. | XMLNode | ||
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
Evalueert het opgegeven object XMLNode, vormt een tekstuele representatie van de XML-structuur (inclusief het knooppunt, onderliggende items en kenmerken) en retourneert het resultaat als een tekenreeks. | XMLNode | ||
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
attributes | eigenschap |
attributes:Object| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Object dat alle kenmerken bevat van de opgegeven instantie XMLNode. Het object XMLNode.attributes bevat één variabele voor elk kenmerk van de instantie XMLNode. Deze variabelen worden gedefinieerd als onderdeel van het object en worden daarom over het algemeen eigenschappen van het object genoemd. De waarde van elk kenmerk wordt als tekenreeks in de bijbehorende eigenschap opgeslagen. Bij een kenmerk met de naam color kunt u bijvoorbeeld de kenmerkwaarde ophalen door color op te geven als de naam van de eigenschap, zoals wordt getoond in de volgende code:
var myColor:String = doc.firstChild.attributes.color
Implementatie
public function get attributes():Object public function set attributes(value:Object):voidchildNodes | eigenschap |
childNodes:Array [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een array van de opgegeven onderliggende items van het object XMLNode. Elk element in de array is een verwijzing naar een object XMLNode dat een onderliggend knooppunt vertegenwoordigt. Dit is een alleen-lezen-eigenschap en kan niet worden gebruikt om onderliggende knooppunten te manipuleren. Gebruik de methoden appendChild(), insertBefore() en removeNode() om onderliggende knooppunten te manipuleren.
Deze eigenschap is ongedefinieerd voor tekstknooppunten (nodeType == 3).
Implementatie
public function get childNodes():ArrayVerwante API-elementen
firstChild | eigenschap |
public var firstChild:XMLNode| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Evalueert het opgegeven object XMLDocument en verwijst naar het eerste item in de lijst met onderliggende items van het bovenliggende knooppunt. Deze eigenschap is null wanneer het knooppunt geen onderliggende items heeft. Deze eigenschap is undefined wanneer het knooppunt een tekstknooppunt is. Dit is een alleen-lezen-eigenschap en kan niet worden gebruikt om onderliggende knooppunten te manipuleren. Gebruik de methoden appendChild(), insertBefore() en removeNode() om onderliggende knooppunten te manipuleren.
Verwante API-elementen
lastChild | eigenschap |
public var lastChild:XMLNode| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een XMLNode-waarde die verwijst naar het laatste item in de lijst met onderliggende items van dit knooppunt. De eigenschap XMLNode.lastChild is null wanneer het knooppunt geen onderliggende items heeft. Deze eigenschap kan niet worden gebruikt om onderliggende knooppunten te manipuleren. Gebruik de methoden appendChild(), insertBefore() en removeNode() om onderliggende knooppunten te manipuleren.
Verwante API-elementen
localName | eigenschap |
localName:String [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Het gedeelte met de lokale naam van het XML-knooppunt. Dit is de elementnaam zonder het naamruimtevoorvoegsel. Het knooppunt <contact:mailbox/>bob@example.com</contact:mailbox> heeft bijvoorbeeld de lokale naam ‘mailbox’ en het voorvoegsel ‘contact’, die de volledige elementnaam ‘contact.mailbox’ vormen.
U kunt het naamruimtevoorvoegsel benaderen via de eigenschap prefix van het object XMLNode. De eigenschap nodeName retourneert de volledige naam (inclusief het voorvoegsel en de lokale naam).
Implementatie
public function get localName():StringnamespaceURI | eigenschap |
namespaceURI:String [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wanneer het XML-knooppunt een voorvoegsel bevat, is namespaceURI de waarde van de declaratie xmlns voor dat voorvoegsel (de URI) die doorgaans de naamruimte-URI wordt genoemd. De declaratie xmlns bevindt zich in het huidige knooppunt of in een knooppunt hoger in de XML-hiërarchie.
Wanneer het XML-knooppunt geen voorvoegsel heeft, hangt de waarde van de eigenschap namespaceURI af van of er een standaardnaamruimte is gedefinieerd (zoals in xmlns="http://www.example.com/"). Wanneer er een standaardnaamruimte is, is de waarde van de eigenschap namespaceURI de waarde van de standaardnaamruimte. Wanneer er geen standaardnaamruimte is, is de eigenschap namespaceURI voor dat knooppunt een lege tekenreeks ("").
U kunt de methode getNamespaceForPrefix() gebruiken om de naamruimte te identificeren die aan een opgegeven voorvoegsel is gekoppeld. De eigenschap namespaceURI retourneert het voorvoegsel dat aan de knooppuntnaam is gekoppeld.
Implementatie
public function get namespaceURI():StringVerwante API-elementen
nextSibling | eigenschap |
public var nextSibling:XMLNode| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een XMLNode-waarde die verwijst naar het volgende item op hetzelfde niveau in de lijst met onderliggende items van het bovenliggende knooppunt. Deze eigenschap is null wanneer het knooppunt geen volgend knooppunt heeft op hetzelfde niveau. Deze eigenschap kan niet worden gebruikt om onderliggende knooppunten te manipuleren. Gebruik de methoden appendChild(), insertBefore() en removeNode() om onderliggende knooppunten te manipuleren.
Verwante API-elementen
nodeName | eigenschap |
public var nodeName:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tekenreeks die de knooppuntnaam van het object XMLNode vertegenwoordigt. Wanneer het XML-object een XML-element is (nodeType == 1), is nodeName de naam van de tag die het knooppunt vertegenwoordigt in het XML-bestand. TITLE is bijvoorbeeld de nodeName van een HTML-tag TITLE. Wanneer het object XMLNode een tekstknooppunt is (nodeType == 3), is nodeName null.
Verwante API-elementen
nodeType | eigenschap |
public var nodeType:uint| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Constante waarde nodeType, XMLNodeType.ELEMENT_NODE voor een XML-element of XMLNodeType.TEXT_NODE voor een tekstknooppunt.
nodeType is een numerieke waarde van de opsommingswaarde van NodeType in de aanbeveling W3C DOM Level 1: http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html. In de onderstaande tabel worden de mogelijke waarden weergegeven:
| Waarde (geheel getal) | Gedefinieerde constante |
|---|---|
| 1 | ELEMENT_NODE |
| 3 | TEXT_NODE |
| 5 | ENTITY_REFERENCE_NODE |
| 7 | PROCESSING_INSTRUCTION_NODE |
| 9 | DOCUMENT_NODE |
| 11 | DOCUMENT_FRAGMENT_NODE |
De ingebouwde klasse XMLNode in Flash Player ondersteunt alleen XMLNodeType.ELEMENT_NODE en XMLNodeType.TEXT_NODE.
Verwante API-elementen
nodeValue | eigenschap |
public var nodeValue:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De knooppuntwaarde van het object XMLDocument. Wanneer het object XMLDocument een tekstknooppunt is, is nodeType 3 en is nodeValue de tekst van het knooppunt. Wanneer het object XMLDocument een XML-element is (nodeType is 1), is nodeValue null en alleen-lezen.
Verwante API-elementen
parentNode | eigenschap |
public var parentNode:XMLNode| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een XMLNode-waarde die naar het bovenliggende knooppunt van het opgegeven XML-object verwijst of die null retourneert wanneer het knooppunt geen bovenliggend item heeft. Dit is een alleen-lezen-eigenschap en kan niet worden gebruikt om onderliggende knooppunten te manipuleren. Gebruik de methoden appendChild(), insertBefore() en removeNode() om onderliggende knooppunten te manipuleren.
Verwante API-elementen
prefix | eigenschap |
prefix:String [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Het gedeelte met het voorvoegsel van de naam van het XML-knooppunt. Het knooppunt <contact:mailbox/>bob@example.com</contact:mailbox> heeft bijvoorbeeld het voorvoegsel ‘contact’ en de lokale naam ‘mailbox’, die de volledige elementnaam ‘contact.mailbox’ vormen.
De eigenschap nodeName van een object XMLNode retourneert de volledige naam (inclusief het voorvoegsel en de lokale naam). U kunt het gedeelte van de lokale naam van het element benaderen via de eigenschap localName.
Implementatie
public function get prefix():StringpreviousSibling | eigenschap |
public var previousSibling:XMLNode| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een XMLNode-waarde die verwijst naar het vorige item op hetzelfde niveau in de lijst met onderliggende items van het bovenliggende knooppunt. De eigenschap heeft een waarde van null wanneer het knooppunt geen vorig knooppunt op hetzelfde niveau heeft. Deze eigenschap kan niet worden gebruikt om onderliggende knooppunten te manipuleren. Gebruik de methoden appendChild(), insertBefore() en removeNode() om onderliggende knooppunten te manipuleren.
Verwante API-elementen
XMLNode | () | Constructor |
public function XMLNode(type:uint, value:String)| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Maakt een nieuw object XMLNode. U moet de constructor gebruiken om een object XMLNode te maken voordat u een methode van de klasse XMLNode aanroept.
Opmerking: gebruik de methoden createElement() en createTextNode() om elementen en tekstknooppunten aan een XML-documentstructuur toe te voegen.
type:uint — Het type knooppunt: de waarde 1 voor een XML-element of 3 voor een tekstknooppunt.
| |
value:String — De XML-tekst die wordt geparseerd om het nieuwe object XMLNode te maken.
|
Verwante API-elementen
appendChild | () | methode |
public function appendChild(node:XMLNode):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Voegt het opgegeven knooppunt toe aan de lijst met onderliggende items van het object XML. Deze methode werkt direct op het knooppunt waarnaar wordt verwezen door de parameter childNode, maar voegt geen kopie van het knooppunt toe. Wanneer het knooppunt dat moet worden toegevoegd al in een andere boomstructuur bestaat, wordt het knooppunt uit de huidige locatie verwijderd bij het toevoegen aan de nieuwe locatie. Wanneer de parameter childNode naar een knooppunt verwijst die al in een andere XML-boomstructuur bestaat, wordt het toegevoegde onderliggende knooppunt in de nieuwe boomstructuur geplaatst nadat het uit het bestaande bovenliggende knooppunt is verwijderd.
Parameters
node:XMLNode — Een XMLNode die het knooppunt vertegenwoordigt dat van de huidige locatie moet worden verplaatst naar de lijst van onderliggende items van het object my_xml.
|
cloneNode | () | methode |
public function cloneNode(deep:Boolean):XMLNode| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Vormt en retourneert een nieuw XML-knooppunt van hetzelfde type en met dezelfde naam, waarde en kenmerken als het opgegeven object XML. Wanneer deep op true is ingesteld, worden alle onderliggende knooppunten recursief gekloond. Dit resulteert in een exacte kopie van de oorspronkelijke boomstructuur van het bestand van het object.
De kloon van het knooppunt dat wordt geretourneerd, wordt niet meer gekoppeld aan de boomstructuur van het gekloonde item. Als gevolg hiervan hebben nextSibling, parentNode en previousSibling allemaal een waarde van null. Wanneer de parameter deep op false is ingesteld of het knooppunt my_xml geen onderliggende knooppunten heeft, is de waarde van firstChild en lastChild ook null.
Parameters
deep:Boolean — Een booleaanse waarde; indien ingesteld op true, worden de onderliggende items van het opgegeven object XML recursief gekloond.
|
XMLNode — Een object XMLNode.
|
getNamespaceForPrefix | () | methode |
public function getNamespaceForPrefix(prefix:String):String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert de naamruimte-URI die aan het opgegeven voorvoegsel voor het knooppunt is gekoppeld. getPrefixForNamespace() doorzoekt zonodig de XML-hiërarchie van het knooppunt en retourneert de naamruimte-URI van de eerste declaratie xmlns voor de opgegeven prefix om de URI te bepalen.
Wanneer voor het opgegeven voorvoegsel geen naamruimte is opgegeven, retourneert de methode null.
Wanneer u een lege tekenreeks ("") als prefix opgeeft en er voor het knooppunt een standaardnaamruimte is gedefinieerd (zoals in xmlns="http://www.example.com/"), retourneert de methode die standaardnaamruimte-URI.
Parameters
prefix:String — Het voorvoegsel waarvoor de methode de gekoppelde naamruimte retourneert.
|
String — De naamruimte die wordt gekoppeld aan het opgegeven voorvoegsel.
|
Verwante API-elementen
getPrefixForNamespace | () | methode |
public function getPrefixForNamespace(ns:String):String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert het voorvoegsel dat aan de opgegeven naamruimte-URI voor het knooppunt is gekoppeld. getPrefixForNamespace() doorzoekt zonodig de XML-hiërarchie van het knooppunt en retourneert het voorvoegsel van de eerste declaratie xmlns met een naamruimte-URI die overeenkomt met ns om het voorvoegsel te bepalen.
Wanneer er geen toewijzing xmlns is voor de opgegeven URI, retourneert de methode null. Wanneer er een toewijzing xmlns is voor de opgegeven URI, maar er is geen voorvoegsel dat aan de toewijzing is gekoppeld, retourneert de methode een lege tekenreeks ("").
Parameters
ns:String — De naamruimte-URI waarvoor de methode het gekoppelde voorvoegsel retourneert.
|
String — Het voorvoegsel dat aan de opgegeven naamruimte is gekoppeld.
|
Verwante API-elementen
hasChildNodes | () | methode |
public function hasChildNodes():Boolean| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geeft aan of het opgegeven object XMLNode onderliggende knooppunten bevat. Deze eigenschap is true wanneer het opgegeven object XMLNode onderliggende knooppunten bevat; anders false.
Boolean — Hiermee wordt true geretourneerd wanneer het opgegeven object XMLNode onderliggende knooppunten bevat; anders false.
|
insertBefore | () | methode |
public function insertBefore(node:XMLNode, before:XMLNode):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Voegt een nieuw onderliggend knooppunt toe in de lijst met onderliggende items van het object XML voor het knooppunt beforeNode. Wanneer de parameter beforeNode ongedefinieerd of nul is, wordt het knooppunt toegevoegd met de methode appendChild(). Wanneer beforeNode geen onderliggend item van my_xml is, mislukt het invoegen.
Parameters
node:XMLNode — Het in te voegen object XMLNode.
| |
before:XMLNode — Het object XMLNode voor het invoegpunt voor de childNode.
|
Verwante API-elementen
removeNode | () | methode |
public function removeNode():void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Verwijdert het opgegeven object XML uit het bovenliggende item. Verwijdert ook alle afstammingen van het knooppunt.
toString | () | methode |
public function toString():String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Evalueert het opgegeven object XMLNode, vormt een tekstuele representatie van de XML-structuur (inclusief het knooppunt, onderliggende items en kenmerken) en retourneert het resultaat als een tekenreeks.
Voor objecten XML op hoofdniveau (die met de constructor zijn gemaakt) voert de methode XMLDocument.toString() de declaratie XML uit van het document (opgeslagen in de eigenschap XMLDocument.xmlDecl), gevolgd door de declaratie DOCTYPE van het document (opgeslagen in de eigenschap XMLDocument.docTypeDecl), gevolgd door de tekstrepresentatie van alle XML-knooppunten in het object. De declaratie XML wordt niet uitgevoerd wanneer de eigenschap XMLDocument.xmlDecl null is. De declaratie DOCTYPE wordt niet uitgevoerd wanneer de eigenschap XMLDocument.docTypeDecl null is.
String — De tekenreeks die het object XMLNode vertegenwoordigt.
|
Verwante API-elementen
package {
import flash.display.Sprite;
import flash.xml.XMLDocument;
import flash.xml.XMLNode;
import flash.xml.XMLNodeType;
public class XMLDocumentExample extends Sprite {
public function XMLDocumentExample() {
var result:XMLDocument = new XMLDocument();
result.ignoreWhite = true;
result.parseXML(getXMLString());
var books:Array = parseBooks(result.firstChild);
trace("books: \n" + books);
}
private function parseBooks(node:XMLNode):Array {
var books:Array = new Array();
var kids:Array = node.childNodes;
for each(var item:XMLNode in kids) {
parseBook(item, books);
}
return books;
}
private function parseBook(node:XMLNode, books:Array):void {
var item:Book = new Book();
item.setPublisher(node.attributes.publisher);
item.setName(node.attributes.name);
books.push(item);
}
private function getXMLString():String {
var list:XML = <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>;
return list.toXMLString();
}
}
}
class Book {
private var publisher:String;
private var name:String;
public function setPublisher(publisher:String):void {
this.publisher = publisher;
}
public function setName(name:String):void {
this.name = name;
}
public function toString():String {
return "[Book name: " + name + " publisher: " + publisher + "]\n";
}
}
Wed Jun 13 2018, 11:42 AM Z