| Pacote | flash.xml |
| Classe | public class XMLNode |
| Herança | XMLNode  Object |
| Subclasses | XMLDocument |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
| attributes : Object
Um objeto contendo todos os atributos da ocorrência de XMLNode especificado. | XMLNode | ||
| childNodes : Array [somente leitura]
Uma matriz dos filhos do objeto XMLNode especificado. | XMLNode | ||
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| firstChild : XMLNode
Avalia o objeto XMLDocument especificado e faz referência ao primeiro filho na lista de filhos do nó pai. | XMLNode | ||
| lastChild : XMLNode
Um valor XMLNode que faz referência ao último filho na lista de filhos do nó. | XMLNode | ||
| localName : String [somente leitura]
A parte do nome local do nome do nó XML. | XMLNode | ||
| namespaceURI : String [somente leitura]
Se o nó XML tiver um prefixo, namespaceURI será o valor da declaração xmlns desse prefixo (o URI), que é normalmente chamado de URI de namespace. | XMLNode | ||
| nextSibling : XMLNode
Um valor XMLNode que faz referência ao próximo irmão na lista de filhos do nó pai. | XMLNode | ||
| nodeName : String
Uma string que representa o nome do nó do objeto XMLNode. | XMLNode | ||
| nodeType : uint
Um valor de constante nodeType, seja XMLNodeType.ELEMENT_NODE para um elemento XML ou XMLNodeType.TEXT_NODE para um nó de texto. | XMLNode | ||
| nodeValue : String
O valor do nó do objeto XMLDocument. | XMLNode | ||
| parentNode : XMLNode
Um valor XMLNode que faz referência ao nó pai do objeto XML especificado ou que retornará null se o nó não tiver um pai. | XMLNode | ||
| prefix : String [somente leitura]
A parte do prefixo do nome do nó XML. | XMLNode | ||
| previousSibling : XMLNode
Um valor XMLNode que faz referência ao irmão anterior na lista de filhos do nó pai. | XMLNode | ||
| Método | Definido por | ||
|---|---|---|---|
Cria um novo objeto XMLNode. | XMLNode | ||
Acrescenta o nó especificado à lista de filhos do objeto XML. | XMLNode | ||
Constrói e retorna um novo nó XML do mesmo tipo, nome, valor e atributos que o objeto XML especificado. | XMLNode | ||
Retorna o URI de namespace associado ao prefixo especificado para o nó. | XMLNode | ||
Retorna o prefixo associado ao URI de namespace especificado para o nó. | XMLNode | ||
Indica se o objeto XMLNode especificado tem nós filhos. | XMLNode | ||
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
Insere um novo nó filho na lista de filhos do objeto XML, antes do nó beforeNode. | XMLNode | ||
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
Remove o objeto XML especificado do seu pai. | XMLNode | ||
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
Avalia o objeto XMLNode especificado, constrói uma representação textual da estrutura XML, incluindo o nó, os filhos e os atributos, e retorna o resultado como uma string. | XMLNode | ||
|
Retorna o valor primitivo do objeto especificado. | Object | |
attributes | propriedade |
attributes:Object| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um objeto contendo todos os atributos da ocorrência de XMLNode especificado. O objeto XMLNode.attributes contém uma variável para cada atributo da ocorrência de XMLNode. Como essas variáveis são definidas como parte do objeto, em geral, são referidas como propriedades do objeto. O valor de cada atributo é armazenado na propriedade correspondente como string. Por exemplo, se você tiver um atributo chamado cor, poderá recuperar o valor desse atributo especificando cor como o nome da propriedade, como mostra o código a seguir:
var myColor:String = doc.firstChild.attributes.color
Implementação
public function get attributes():Object public function set attributes(value:Object):voidchildNodes | propriedade |
childNodes:Array [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Uma matriz dos filhos do objeto XMLNode especificado. Cada elemento da matriz é uma referência a um objeto XMLNode que representa um nó filho. Esta é uma propriedade somente leitura e não pode ser usada para manipular nós filhos. Use os métodos appendChild(), insertBefore() e removeNode() para manipular os nós filhos.
Esta propriedade é indefinida para nós de texto (nodeType == 3).
Implementação
public function get childNodes():ArrayElementos da API relacionados
firstChild | propriedade |
public var firstChild:XMLNode| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Avalia o objeto XMLDocument especificado e faz referência ao primeiro filho na lista de filhos do nó pai. Esta propriedade é null se o nó não tiver filhos. Esta propriedade é indefinida se o nó for um nó de texto. Esta é uma propriedade somente leitura e não pode ser usada para manipular os nós filhos; use os métodos appendChild(), insertBefore() e removeNode() para manipular os nós filhos.
Elementos da API relacionados
lastChild | propriedade |
public var lastChild:XMLNode| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor XMLNode que faz referência ao último filho na lista de filhos do nó. A propriedade XMLNode.lastChild é null se o nó não tiver filhos. Esta propriedade não pode ser usada para manipular os nós filhos; use os métodos appendChild(), insertBefore() e removeNode() para manipular os nós filhos.
Elementos da API relacionados
localName | propriedade |
localName:String [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A parte do nome local do nome do nó XML. Este é o nome do elemento sem o prefixo do namespace. Por exemplo, o nó <contact:mailbox/>bob@example.com</contact:mailbox> tem o nome local "mailbox" e o prefixo "contact", que formam o nome completo do elemento "contact.mailbox".
Você pode acessar o prefixo do namespace pela propriedade prefixo do objeto do nó XML. A propriedade nodeName retorna o nome completo (inclusive o prefixo e o nome local).
Implementação
public function get localName():StringnamespaceURI | propriedade |
namespaceURI:String [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se o nó XML tiver um prefixo, namespaceURI é o valor xmlns desse prefixo (o URI), que é normalmente chamado de URI de namespace. A declaração xmlns está no nó atual ou em um nó mais alto na hierarquia XML.
Se o nó XML não tiver um prefixo, o valor da propriedade namespaceURI depende de haver um namespace padrão definido (como em xmlns="http://www.example.com/"). Se houver um namespace padrão, o valor da propriedade namespaceURI é o valor do namespace padrão. Se não houver um namespace padrão, a propriedade namespaceURI para esse nó é uma string vazia ("").
Você pode usar o método getNamespaceForPrefix() para identificar o namespace associado com um prefixo específico. A propriedade namespaceURI retorna o prefixo associado com o nome do nó.
Implementação
public function get namespaceURI():StringElementos da API relacionados
nextSibling | propriedade |
public var nextSibling:XMLNode| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor XMLNode que faz referência ao próximo irmão na lista de filhos do nó pai. Esta propriedade é null se o nó não tiver um nó irmão anterior. Esta propriedade não pode ser usada para manipular os nós filhos; use os métodos appendChild(), insertBefore() e removeNode() para manipular os nós filhos.
Elementos da API relacionados
nodeName | propriedade |
public var nodeName:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Uma string que representa o nome do nó do objeto XMLNode. Se o objeto XMLNode for um elemento XML (nodeType == 1), nodeName é o nome da marca que representa o nó no arquivo XML. Por exemplo, TITLE é o nodeName de uma marca HTML TITLE. Se o objeto XMLNode for um nó de texto (nodeType == 3), nodeName é null.
Elementos da API relacionados
nodeType | propriedade |
public var nodeType:uint| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor de constante nodeType, seja XMLNodeType.ELEMENT_NODE para um elemento XML ou XMLNodeType.TEXT_NODE para um nó de texto.
O nodeType é um valor numérico da enumeração NodeType na recomendação Nível 1 W3C DOM: http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html_br. A tabela a seguir lista os valores:
| Valor da integral | Constante definida |
|---|---|
| 1 | ELEMENT_NODE |
| 3 | TEXT_NODE |
| 5 | ENTITY_REFERENCE_NODE |
| 7 | PROCESSING_INSTRUCTION_NODE |
| 9 | DOCUMENT_NODE |
| 11 | DOCUMENT_FRAGMENT_NODE |
No Flash Player, a classe XMLNode embutida suporta apenas XMLNodeType.ELEMENT_NODE e XMLNodeType.TEXT_NODE.
Elementos da API relacionados
nodeValue | propriedade |
public var nodeValue:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O valor do nó do objeto XMLDocument. Se o objeto XMLDocument for um nó de texto, o nodeType é 3 e o nodeValue é o texto do nó. Se o objeto XMLDocument for um elemento XML (nodeType é 1), o nodeValue é null e somente leitura.
Elementos da API relacionados
parentNode | propriedade |
public var parentNode:XMLNode| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor XMLNode que faz referência ao nó pai do objeto XML especificado ou que retornará null se o nó não tiver um pai. Esta é uma propriedade somente leitura e não pode ser usada para manipular os nós filhos; use os métodos appendChild(), insertBefore() e removeNode() para manipular os nós filhos.
Elementos da API relacionados
prefix | propriedade |
prefix:String [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A parte do prefixo do nome do nó XML. Por exemplo, o nó <contact:mailbox/>bob@example.com</contact:mailbox> tem o nome local "mailbox" e o prefixo "contact", que formam o nome completo do elemento "contact.mailbox".
A propriedade nodeName de um objeto do nó XML retorna o nome completo (inclusive o prefixo e o nome local). Você pode acessar a parte do nome local do nome do elemento pela propriedade localName.
Implementação
public function get prefix():StringpreviousSibling | propriedade |
public var previousSibling:XMLNode| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um valor XMLNode que faz referência ao irmão anterior na lista de filhos do nó pai. A propriedade tem valor nulo se o nó não tiver um nó irmão anterior. Esta propriedade não pode ser usada para manipular os nós filhos; use os métodos appendChild(), insertBefore() e removeNode() para manipular os nós filhos.
Elementos da API relacionados
XMLNode | () | Construtor |
public function XMLNode(type:uint, value:String)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cria um novo objeto XMLNode. Você precisa usar o construtor para criar um objeto XMLNode, antes de chamar qualquer dos métodos da classe XMLNode.
Observação: Use os métodos createElement() e createTextNode() para acrescentar elementos e nós de texto a uma árvore de documento XML.
type:uint — O tipo de nó: seja 1 para um elemento XML ou 3 para o nó de texto.
| |
value:String — O texto XML analisado para criar o novo objeto XMLNode.
|
Elementos da API relacionados
appendChild | () | método |
public function appendChild(node:XMLNode):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Acrescenta o nó especificado à lista de filhos do objeto XML. Este método opera diretamente no nó indicado pelo parâmetro childNode; não anexa uma cópia do nó. Se o nó a ser anexado já existe em outra estrutura de árvore, a anexação do nó em outro local vai removê-lo de seu local atual. Se o parâmetro childNode refere-se a um nó que já existe em outra estrutura de árvore XML, o nó filho anexado é colocado na nova estrutura de árvore, depois de ser removido do nó pai existente.
Parâmetros
node:XMLNode — Um XMLNode que representa o nó a ser movido do local atual para a lista de filhos do objeto my_xml.
|
cloneNode | () | método |
public function cloneNode(deep:Boolean):XMLNode| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Constrói e retorna um novo nó XML do mesmo tipo, nome, valor e atributos que o objeto XML especificado. Se profundo for configurado para true, todos os nós filhos são repetidamente clonados, o que resulta na cópia exata da árvore de documento do objeto original.
O clone do nó retornado já não é mais associado com a árvore do item clonado. Consequentemente, nextSibling, parentNode e previousSibling têm o valor de null. Se o parâmetro profundo for configurado para false ou o nó my_xml não tem nós filhos, firstChild e lastChild também são nulos.
Parâmetros
deep:Boolean — Um valor booliano; se configurado para true, os filhos do objeto XML especificado serão repetidamente clonados.
|
XMLNode — Um objeto XMLNode.
|
getNamespaceForPrefix | () | método |
public function getNamespaceForPrefix(prefix:String):String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna o URI de namespace associado ao prefixo especificado para o nó. Para determinar o URI, getPrefixForNamespace() busca a hierarquia XML do nó, se necessário, e retorna o URI de namespace da primeira declaração xmlns para o prefixo dado.
Se não houver namespace definido para o prefixo especificado, o método retorna null.
Se você especificar uma string vazia ("") como o prefixo e houver um namespace padrão definido para o nó (como em xmlns="http://www.example.com_br/"), o método retorna esse URI de namespace padrão.
Parâmetros
prefix:String — O prefixo para o qual o método retorna o namespace associado.
|
String — O namespace associado com o prefixo especificado.
|
Elementos da API relacionados
getPrefixForNamespace | () | método |
public function getPrefixForNamespace(ns:String):String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna o prefixo associado ao URI de namespace especificado para o nó. Para determinar o prefixo, getPrefixForNamespace() busca a hierarquia XML do nó, se necessário, e retorna o prefixo da primeira declaração xmlns com o URI de namespace compatível com ns.
Se não houver atribuição xmlns para o URI dado, o método retorna null. Se houver uma atribuição xmlns para o URI dado, mas não há prefixo associado à atribuição, o método retorna uma string vazia ("").
Parâmetros
ns:String — O URI de namespace para o qual o método retorna o prefixo associado.
|
String — O prefixo associado com o namespace especificado.
|
Elementos da API relacionados
hasChildNodes | () | método |
public function hasChildNodes():Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica se o objeto XMLNode especificado tem nós filhos. Esta propriedade é verdadeira se o objeto XMLNode especificado tem nós filhos; do contrário, é false.
Boolean — Retorna true se o objeto XMLNode especificado tem nós filhos; do contrário, false.
|
insertBefore | () | método |
public function insertBefore(node:XMLNode, before:XMLNode):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Insere um novo nó filho na lista de filhos do objeto XML, antes do nó beforeNode. Se o parâmetro beforeNode for indefinido ou nulo, o nó é incluído com o uso do método appendChild(). Se o beforeNode não é filho do my_xml, falha a inserção.
Parâmetros
node:XMLNode — O objeto XMLNode a ser inserido.
| |
before:XMLNode — O objeto XMLNode antes do ponto de inserção do childNode.
|
Elementos da API relacionados
removeNode | () | método |
public function removeNode():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Remove o objeto XML especificado do seu pai. Exclui também todos os descendentes do nó.
toString | () | método |
public function toString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Avalia o objeto XMLNode especificado, constrói uma representação textual da estrutura XML, incluindo o nó, os filhos e os atributos, e retorna o resultado como uma string.
Para objetos XMLDocument de nível superior (aqueles criados com o construtor), o método XMLDocument.toString() dá saída à declaração XML do documento (armazenada na propriedade XMLDocument.xmlDecl), seguida pela declaração DOCTYPE do documento (armazenada na propriedade XMLDocument.docTypeDecl), seguida pela representação de texto de todos os nós XML do objeto. A declaração XML não é enviada se a propriedade XMLDocument.xmlDecl for null. A declaração DOCTYPE não é enviada se a propriedade XMLDocument.docTypeDecl for null.
String — A string que representa o objeto XMLNode.
|
Elementos da API relacionados
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:10 AM Z