XML - Referencia del lenguaje y componentes ActionScript 3.

Paquete Clase Herencia Nivel superior public final dynamic class XML XML Object

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 La clase XML contiene mtodos y propiedades para trabajar con objetos XML. La clase XML (junto con las clases XMLList, Namespace y QName) implementa potentes normas de gestin de XML definidas en la especificacin ECMAScript para XML (E4X) (ECMA-357 edicin 2). Utilice el mtodo toXMLString() para que se devuelva una representacin de cadena del objeto XML, con independencia de si el objeto XML tiene contenido simple o complejo. Nota : la clase XML (junto con las clases relacionadas) de ActionScript 2.0 ha pasado a denominarse XMLDocument y se ha trasladado al paquete flash.xml. Se incluye en ActionScript 3.0 para conseguir compatibilidad retroactiva. Ver los ejemplos Vase tambin Namespace QName XMLList XML.toXMLString() Especificacin ECMAScript para XML (E4X) (ECMA-357; edicin 2) Objetos XML

Propiedades pblicas
Mostrar propiedades pblicas heredadas Propiedad ignoreComments : Boolean [static] Determina si los comentarios XML se ignoran cuando los objetos XML analizan los datos XML de origen. ignoreProcessingInstructions : Boolean [static] Determina si las instrucciones de procesamiento XML se ignoran cuando los objetos XML analizan los datos XML de origen. ignoreWhitespace : Boolean [static] Determina si los caracteres de espacio en blanco situados al comienzo y al final de los nodos de texto deben ignorarse durante el anlisis. prettyIndent : int [static] Determina la cantidad de sangra que se aplica a los mtodos toString() y toXMLString() cuando la propiedad XML.prettyPrinting se establece con el valor true. prettyPrinting : Boolean [static] Determina si los mtodos toString() y toXMLString() normalizan los caracteres de espacio en blanco existentes entre algunas etiquetas. Definido por XML

XML

XML

XML

XML

Mtodos pblicos
Mostrar mtodos pblicos heredados Mtodo XML(value:Object) Crea un nuevo objeto XML. addNamespace (ns:Object):XML Aade un espacio de nombres al conjunto de espacios de nombres del mbito para el objeto XML. Definido por XML XML

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

appendChild (child:Object):XML Aade el elemento secundario en cuestin al final de las propiedades del objeto XML. attribute(attributeName:*):XMLList Devuelve el valor XML del atributo cuyo nombre coincide con el parmetro attributeName. attributes ():XMLList Devuelve una lista de valores de atributos para el objeto XML en cuestin. child (propertyName:Object):XMLList Enumera los elementos secundarios de un objeto XML. childIndex ():int Identifica la posicin de ndice basada en cero de este objeto XML dentro del contexto de su elemento principal. children():XMLList Enumera los elementos secundarios del objeto XML en la secuencia en que aparecen. comments():XMLList Enumera las propiedades del objeto XML que contienen comentarios XML. contains (value:XML):Boolean Compara el objeto XML con el parmetro value especificado. copy ():XML Devuelve una copia del objeto XML en cuestin. defaultSettings ():Object [static] Devuelve un objeto con las siguientes propiedades configuradas con los valores predeterminados: ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent y prettyPrinting. descendants(name:Object = *):XMLList Devuelve todos los descendientes (elementos secundarios, terciarios, cuaternarios, etc.) del objeto XML que tiene el parmetro name. elements(name:Object = *):XMLList Enumera los elementos de un objeto XML. hasComplexContent ():Boolean Comprueba si el objeto XML tiene un contenido complejo. hasOwnProperty (p:String):Boolean Comprueba si el objeto tiene la propiedad especificada por el parmetro p. hasSimpleContent ():Boolean Comprueba si el objeto XML tiene un contenido simple. inScopeNamespaces ():Array Enumera los espacios de nombres para el objeto XML basndose en el elemento principal del objeto. insertChildAfter (child1:Object, child2:Object):* Introduce el parmetro child2 especificado tras el parmetro child1 en este objeto XML y devuelve el objeto resultante. insertChildBefore(child1:Object, child2:Object):* Introduce el parmetro child2 especificado delante del parmetro child1 en este objeto XML y devuelve el objeto resultante. length():int En el caso de objetos XML, este mtodo siempre devuelve el entero 1. localName ():Object Proporciona la parte local del nombre completo del objeto XML. name ():Object Proporciona el nombre completo del objeto XML. namespace (prefix:String = null):* Si no se especifica ningn parmetro, proporciona el espacio de nombres asociado al nombre completo de este objeto XML. namespaceDeclarations ():Array Enumera las declaraciones de espacio de nombres asociadas al objeto XML en el contexto de su elemento principal. nodeKind():String Especifica el tipo de nodo: texto, comentario, instruccin de procesamiento, atributo o elemento. normalize ():XML Para el objeto XML y todos los objetos XML descendientes, funde los nodos de texto adyacentes y

XML XML XML XML XML

XML XML XML XML XML

XML

XML XML XML XML XML XML

XML

XML XML XML XML

XML

XML XML

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

elimina los nodos de texto vacos. parent ():* Devuelve el elemento principal del objeto XML. prependChild(value:Object):XML Introduce una copia del objeto child (secundario) proporcionado en el elemento XML delante de cualquier propiedad XML existente para dicho elemento. processingInstructions (name:String = "*"):XMLList Si se proporciona un parmetro name, enumera todos los elementos secundarios del objeto XML que contienen instrucciones de procesamiento con dicho nombre. propertyIsEnumerable (p:String):Boolean Comprueba si la propiedad p est en el conjunto de propiedades que se pueden repetir en una sentencia for..in aplicada al objeto XML. removeNamespace (ns:Namespace):XML Elimina el espacio de nombres proporcionado para este objeto y todos los descendientes. replace(propertyName:Object, value:XML):XML Sustituye las propiedades especificadas mediante el parmetro propertyName por el parmetro value en cuestin. setChildren (value:Object):XML Sustituye las propiedades secundarias del objeto XML por el conjunto especificado de propiedades XML, proporcionadas en el parmetro value. setLocalName(name:String):void Cambia el nombre local del objeto XML al parmetro name especificado. setName(name:String):void Establece el nombre del objeto XML con el nombre completo o nombre de atributo especificado. setNamespace(ns:Namespace):void Establece el espacio de nombres asociado al objeto XML. setSettings(... rest):void [static] Establece valores para las siguientes propiedades XML: ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent y prettyPrinting. settings ():Object [static] Recupera las siguientes propiedades: ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent y prettyPrinting. text ():XMLList Devuelve un objeto XMLList con todas las propiedades XML del objeto XML que representan los nodos de texto XML. toString ():String Devuelve una representacin de cadena del objeto XML. toXMLString ():String Devuelve una representacin de cadena del objeto XML. valueOf ():XML Devuelve el objeto XML. XML XML

XML

XML

XML XML

XML

XML XML XML XML

XML

XML

XML XML XML

Informacin sobre propiedades

ignoreComments
propiedad ignoreComments:Boolean[read-write]

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Determina si los comentarios XML se ignoran cuando los objetos XML analizan los datos XML de origen. De forma predeterminada, los comentarios se ignoran (true). Para incluir comentarios XML, establezca esta propiedad con el valor false . La propiedad ignoreComments slo se utiliza durante el anlisis XML, no durante la llamada a mtodos tales como myXMLObject.child(*).toXMLString(). Si el XML de origen incluye nodos de comentarios, stos se mantendrn o se eliminarn durante el anlisis XML. Implementacin
http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 public static function get ignoreComments():Boolean public function set ignoreComments(value:Boolean):void

Vase tambin XML.child() XML.toXMLString() Ejemplo Este ejemplo muestra el efecto que tiene definir XML.ignoreComments como false y como true:
XML.ignoreComments = false; var xml1:XML = <foo> <!-- comment --> </foo>; trace(xml1.toXMLString()); // <foo><!-- comment --></foo> XML.ignoreComments = true; var xml2:XML = <foo> <!-- example --> </foo>; trace(xml2.toXMLString()); // <foo/>

ignoreProcessingInstructions

propiedad ignoreProcessingInstructions:Boolean[read-write]

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Determina si las instrucciones de procesamiento XML se ignoran cuando los objetos XML analizan los datos XML de origen. De forma predeterminada, las instrucciones de procesamiento se ignoran (true). Para incluir instrucciones de procesamiento XML, establezca esta propiedad con el valor false . La propiedad ignoreProcessingInstructions slo se utiliza durante el anlisis XML, no durante la llamada a mtodos tales como myXMLObject.child(*).toXMLString(). Si el XML de origen incluye nodos de instrucciones de procesamiento, stos se mantendrn o se eliminarn durante el anlisis XML. Implementacin
public static function get ignoreProcessingInstructions():Boolean public function set ignoreProcessingInstructions(value:Boolean):void

Vase tambin XML.child() XML.toXMLString() Ejemplo Este ejemplo muestra el efecto que tiene definir XML.ignoreProcessingInstructions como false y como true:
XML.ignoreProcessingInstructions = false; var xml1:XML = <foo> <?exampleInstruction ?> </foo>; trace(xml1.toXMLString()); // <foo><?exampleInstruction ?></foo> XML.ignoreProcessingInstructions = true; var xml2:XML = <foo> <?exampleInstruction ?> </foo>; trace(xml2.toXMLString()); // <foo/>

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

ignoreWhitespace

propiedad ignoreWhitespace:Boolean[read-write]

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Determina si los caracteres de espacio en blanco situados al comienzo y al final de los nodos de texto deben ignorarse durante el anlisis. De manera predeterminada, el espacio en blanco se ignora (true). Si un nodo de texto es espacio en blanco al 100% y la propiedad ignoreWhitespace se define en el valor true, el nodo no se crear. Para mostrar el espacio en blanco en un nodo de texto, defina la propiedad ignoreWhitespace con el valor false . Implementacin
public static function get ignoreWhitespace():Boolean public function set ignoreWhitespace(value:Boolean):void

Ejemplo Este ejemplo muestra el efecto que tiene definir XML.ignoreWhitespace como false y como true:
XML.ignoreWhitespace = false; var xml1:XML = <foo> </foo>; trace(xml1.children().length()); // 1 XML.ignoreWhitespace = true; var xml2:XML = <foo> </foo>; trace(xml2.children().length()); // 0

prettyIndent

propiedad prettyIndent:int[read-write]

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Determina la cantidad de sangra que se aplica a los mtodos toString() y toXMLString() cuando la propiedad XML.prettyPrinting se define con el valor true. La sangra se aplica con el carcter de espacio, no con el carcter de tabulador. El valor predeterminado es 2 . Implementacin
public static function get prettyIndent():int public function set prettyIndent(value:int):void

Vase tambin prettyPrinting toString() toXMLString() Ejemplo Este ejemplo muestra el efecto que tiene definir la propiedad esttica XML.prettyIndent:
var xml:XML = <foo><bar/></foo>; XML.prettyIndent = 0; trace(xml.toXMLString()); XML.prettyIndent = 1; trace(xml.toXMLString()); XML.prettyIndent = 2; trace(xml.toXMLString());

prettyPrinting

propiedad prettyPrinting:Boolean[read-write]

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Determina si los mtodos toString() y toXMLString() normalizan los caracteres de espacio en blanco existentes entre algunas etiquetas. El valor predeterminado es true. Implementacin
public static function get prettyPrinting():Boolean public function set prettyPrinting(value:Boolean):void

Vase tambin prettyIndent toString() toXMLString() Ejemplo Este ejemplo muestra el efecto que tiene definir la propiedad esttica XML.prettyPrinting :
var xml:XML = <foo><bar/></foo>; XML.prettyPrinting = false; trace(xml.toXMLString()); XML.prettyPrinting = true; trace(xml.toXMLString());

Informacin sobre constructores

XML ()
constructor

public function XML(value:Object)

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Crea un nuevo objeto XML. Deber utilizar el constructor para crear un objeto XML antes de llamar a cualquiera de los mtodos de la clase XML. Utilice el mtodo toXMLString() para que se devuelva una representacin de cadena del objeto XML, con independencia de si el objeto XML tiene contenido simple o complejo. Parmetros
value:Object Cualquier objeto que pueda convertirse a XML con la funcin XML() de nivel superior.

Vase tambin Funcin XML() de nivel superior XML.toXMLString() Objetos XML

Informacin sobre mtodos

addNamespace ()
mtodo

AS3 function addNamespace(ns:Object):XML

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Aade un espacio de nombres al conjunto de espacios de nombres del mbito para el objeto XML. Si el espacio de
http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

nombres ya existe en los espacios de nombres del mbito para el objeto XML (con un prefijo que coincide con el del parmetro especificado), el prefijo del espacio de nombres existente se establece en undefined . Si el parmetro de entrada es un objeto Namespace, ste se utiliza directamente. Si es un objeto QName, el URI del parmetro de entrada se utiliza para crear un nuevo espacio de nombres; en caso contrario, se convierte a una cadena y se crea un espacio de nombres a partir de la cadena. Parmetros
ns:Object El espacio de nombres que se va a aadir al objeto XML.

Valor devuelto XML El nuevo objeto XML con el espacio de nombres aadido. Vase tambin Objetos XML Ejemplo Este ejemplo utiliza un espacio de nombres definido en un objeto XML y lo aplica a otro objeto XML:
var xml1:XML = <ns:foo xmlns:ns="www.example.com/ns" />; var nsNamespace:Namespace = xml1.namespace(); var xml2:XML = <bar />; xml2.addNamespace(nsNamespace); trace(xml2.toXMLString()); // <bar xmlns:ns="www.example.com/ns"/>

appendChild ()

mtodo

AS3 function appendChild(child:Object):XML

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Aade el elemento secundario en cuestin al final de las propiedades del objeto XML. El mtodo appendChild() toma un objeto XML, un objeto XMLList o cualquier otro tipo de datos que luego se convierte a String. Utilice el operador delete (XML) para eliminar nodos XML. Parmetros
child:Object El objeto XML que se va a aadir.

Valor devuelto XML El objeto XML resultante. Vase tambin Operador delete (XML) El enfoque E4X del procesamiento de XML Objetos XML Construccin y transformacin de objetos XML Ejemplo Este ejemplo aade un nuevo elemento al final de la lista de elementos secundarios de un objeto XML:
var xml:XML = <body> <p>hello</p> </body>; xml.appendChild(<p>world</p>); trace(xml.p[0].toXMLString()); // <p>hello</p> trace(xml.p[1].toXMLString()); // <p>world</p>

attribute ()

mtodo

AS3 function attribute(attributeName:*):XMLList

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Devuelve el valor XML del atributo cuyo nombre coincide con el parmetro attributeName. Los atributos se encuentran dentro de los elementos XML. En el ejemplo siguiente, el elemento tiene un atributo llamado " gender " con el valor " boy": <first gender="boy">John</first>. El parmetro attributeName puede tener cualquier tipo de datos; sin embargo, el tipo de datos que suele utilizarse es String. Al pasar cualquier objeto que no sea un objeto QName, el parmetro attributeName utiliza el mtodo toString() para convertir el parmetro en una cadena. Si necesita una referencia de nombre completa, puede pasar un objeto QName. Un objeto QName define un espacio de nombre y el nombre local, que puede utilizar para definir el nombre completo de un atributo. Por consiguiente, llamar a attribute(qname) no es lo mismo que llamar a attribute(qname.toString()) . Parmetros
attributeName:* El nombre del atributo.

Valor devuelto XMLList Un objeto XMLList o un objeto XMLList vaco. Devuelve un objeto XMLList vaco si no se ha definido un valor de atributo. Vase tambin XML.attributes() QName Namespace XML.elements() Operador de identificador de atributo (@) Objetos XML Navegacin de estructuras XML Ejemplo Este ejemplo muestra un objeto QName transferido al mtodo attribute() . La propiedad localName es attr y la propiedad namespace es ns .
var xml:XML = <ns:node xmlns:ns = "http://uri" ns:attr = '7' /> var qn:QName = new QName("http://uri", "attr"); trace(xml.attribute(qn)); // 7

attribute() y no el operador de identificador de atributos (@), tal como se indica en el ejemplo siguiente: var xml:XML = <example class="first" /> trace(xml.attribute("class"));

Para devolver un atributo con un nombre que coincida con una palabra clave de ActionScript, utilice el mtodo

attributes ()

mtodo

AS3 function attributes():XMLList

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Devuelve una lista de valores de atributos para el objeto XML en cuestin. Utilice el mtodo name() con el mtodo attributes() para que se devuelva el nombre de un atributo. Utilice @* para que se devuelvan los nombres de todos los atributos. Valor devuelto XMLList La lista de valores de atributos. Vase tambin XML.attribute() XML.name() Operador @ Objetos XML
http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

Navegacin de estructuras XML Ejemplo El siguiente ejemplo devuelve el nombre del atributo:
var xml:XML=<example id='123' color='blue'/> trace(xml.attributes()[1].name()); //color

Este ejemplo devuelve los nombres de todos los atributos:

var xml:XML = <example id='123' color='blue'/> var attNamesList:XMLList = xml.@*; trace(attNamesList is XMLList); // true trace(attNamesList.length()); // 2 for (var i:int = 0; i < attNamesList.length(); i++) { trace(typeof (attNamesList[i])); // xml trace(attNamesList[i].nodeKind()); // attribute trace(attNamesList[i].name()); // id and color }

child ()

mtodo

AS3 function child(propertyName:Object):XMLList

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Enumera los elementos secundarios de un objeto XML. Un elemento secundario XML es un elemento XML, un nodo de texto, un comentario o una instruccin de procesamiento. Utilice el parmetro propertyName para enumerar el contenido de un elemento secundario XML concreto. Por ejemplo, para que se devuelva el contenido de un elemento secundario llamado <first>, utilice child.name("first") . Puede generar el mismo resultado utilizando el nmero de ndice del elemento secundario. El nmero de ndice identifica la posicin del elemento secundario en la lista de otros elementos secundarios XML. Por ejemplo, name.child(0) devuelve el primer elemento secundario de una lista. Utilice un asterisco (*) para que en la salida se incluyan todos los elementos secundarios de un documento XML. Por ejemplo, doc.child("*") . Utilice el mtodo length() con el parmetro de asterisco (*) del mtodo child() para que en la salida se incluya el nmero total de elementos secundarios. Por ejemplo, numChildren = doc.child("*").length() . Parmetros
propertyName:Object El nombre del elemento o el entero del elemento secundario XML.

Valor devuelto XMLList Un objeto XMLList de nodos secundarios que coinciden con el parmetro de entrada. Vase tambin XML.elements() Clase XMLList XML.length() Objetos XML Navegacin de estructuras XML Ejemplo Este ejemplo ilustra el uso del mtodo child() para identificar elementos secundarios con un nombre especificado:
var xml:XML = <foo> <bar>text1</bar>

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 <bar>text2</bar> </foo>; trace(xml.child("bar").length()); // 2 trace(xml.child("bar")[0].toXMLString()); // <bar>text1</bar> trace(xml.child("bar")[1].toXMLString()); // <bar>text2</bar>

childIndex ()

mtodo

AS3 function childIndex():int

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Identifica la posicin de ndice basada en cero de este objeto XML dentro del contexto de su elemento principal. Valor devuelto int La posicin del objeto. Devuelve -1 adems de enteros positivos. Vase tambin Objetos XML Ejemplo Este ejemplo muestra el uso del mtodo childIndex():
var xml:XML = <foo> <bar /> text <bob /> </foo>; trace(xml.bar.childIndex()); // 0 trace(xml.bob.childIndex()); // 2

children ()

mtodo

AS3 function children():XMLList

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Enumera los elementos secundarios del objeto XML en la secuencia en que aparecen. Un elemento secundario XML es un elemento XML, un nodo de texto, un comentario o una instruccin de procesamiento. Valor devuelto XMLList Un objeto XMLList de los elementos secundarios del objeto XML. Vase tambin Objetos XML Ejemplo Este ejemplo muestra el uso del mtodo children() :
XML.ignoreComments = false; XML.ignoreProcessingInstructions = false; var xml:XML = <foo id="22"> <bar>44</bar> text <!-- comment --> <?instruction ?> </foo>; trace(xml.children().length()); // 4 trace(xml.children()[0].toXMLString()); // trace(xml.children()[1].toXMLString()); // trace(xml.children()[2].toXMLString()); // trace(xml.children()[3].toXMLString()); //

<bar>44</bar> text <!-- comment --> <?instruction ?>

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

comments ()

mtodo

AS3 function comments():XMLList

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Enumera las propiedades del objeto XML que contienen comentarios XML. Valor devuelto XMLList Un objeto XMLList de las propiedades que contienen comentarios. Vase tambin Objetos XML Ejemplo Este ejemplo muestra el uso del mtodo comments() :
XML.ignoreComments = false; var xml:XML = <foo> <!-- example --> <!-- example2 --> </foo>; trace(xml.comments().length()); // 2 trace(xml.comments()[1].toXMLString()); // <!-- example2 -->

contains ()

mtodo

AS3 function contains(value:XML):Boolean

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Compara el objeto XML con el parmetro value especificado. Parmetros
value:XML Un valor que se va a comparar con el objeto XML actual.

Valor devuelto Boolean Si el objeto XML coincide con el parmetro value , el valor es true; en caso contrario, el valor es false . Vase tambin Objetos XML Ejemplo Este ejemplo muestra el uso del mtodo contains() :
var xml:XML = <order> <item>Rice</item> <item>Kung Pao Shrimp</item> </order>; trace(xml.item[0].contains(<item>Rice</item>)); // true trace(xml.item[1].contains(<item>Kung Pao Shrimp</item>)); // true trace(xml.item[1].contains(<item>MSG</item>)); // false

copy ()

mtodo

AS3 function copy():XML

Versin del lenguaje:ActionScript 3.0

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

Versin del reproductor:Flash Player 9 Devuelve una copia del objeto XML en cuestin. La copia es un duplicado de todo el rbol de nodos. El objeto XML copiado no tiene elemento principal y devuelve null si intenta llamar al mtodo parent(). Valor devuelto XML La copia del objeto. Vase tambin Objetos XML Ejemplo Este ejemplo muestra que el mtodo copy() crea una nueva instancia de un objeto XML. Al modificar la copia, el original permanece intacto:
var xml1:XML = <foo />; var xml2:XML = xml1.copy(); xml2.appendChild(<bar />); trace(xml1.bar.length()); // 0 trace(xml2.bar.length()); // 1

defaultSettings ()

mtodo

AS3 static function defaultSettings():Object

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Devuelve un objeto con las siguientes propiedades configuradas con los valores predeterminados: ignoreComments , ignoreProcessingInstructions , ignoreWhitespace, prettyIndent y prettyPrinting . Los valores predeterminados son los siguientes:
ignoreComments = true ignoreProcessingInstructions = true ignoreWhitespace = true prettyIndent = 2 prettyPrinting = true

Nota: este mtodo no se aplica a una instancia de la clase XML, sino que se aplica a XML, como en el siguiente cdigo: var df:Object = XML.defaultSettings(). Valor devuelto Object Un objeto con propiedades configuradas con los valores predeterminados. Vase tambin XML.ignoreComments XML.ignoreProcessingInstructions XML.ignoreWhitespace XML.prettyIndent XML.prettyPrinting XML.setSettings() XML.settings() Objetos XML Ejemplo El ejemplo siguiente demuestra: cmo aplicar una configuracin personalizada (para incluir comentarios e instrucciones de procesamiento) antes de definir un objeto XML; cmo recuperar la configuracin predeterminada otra vez antes de definir otro objeto XML; y cmo definir la configuracin personalizada de nuevo (para seguir definiendo ms objetos XML):
XML.ignoreComments = false; XML.ignoreProcessingInstructions = false; var customSettings:Object = XML.settings(); var xml1:XML = <foo> <!-- comment -->

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 <?instruction ?> </foo>; trace(xml1.toXMLString()); // <foo> // <!-- comment --> // <?instruction ?> // </foo> XML.setSettings(XML.defaultSettings()); var xml2:XML = <foo> <!-- comment --> <?instruction ?> </foo>; trace(xml2.toXMLString());

descendants ()

mtodo

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

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Devuelve todos los descendientes (elementos secundarios, terciarios, cuaternarios, etc.) del objeto XML que tiene el parmetro name. El parmetro name es opcional. El parmetro name puede ser un objeto QName, un tipo de datos String o cualquier otro tipo de datos que luego se convierte a un tipo de datos String. Para devolver todos los descendientes, utilice el parmetro "*". Si no se pasa ningn parmetro, se pasa la cadena "*" y se devuelven todos los descendientes del objeto XML. Parmetros
name:Object (default = * ) El nombre del elemento con el que va a establecerse la correspondencia.

Valor devuelto XMLList Un objeto XMLList con los descendientes coincidentes. Si no hay descendientes, devuelve un objeto XMLList vaco. Vase tambin Operador descendant accessor (..) (..) Ejemplo Para devolver descendientes con nombres que coincidan con palabras reservadas de ActionScript, utilice el mtodo descendants() y no el operador descendant (..), como se muestra en el siguiente ejemplo:
var xml:XML = <enrollees> <student id="239"> <class name="Algebra" /> <class name="Spanish 2"/> </student> <student id="206"> <class name="Trigonometry" /> <class name="Spanish 2" /> </student> </enrollees> trace(xml.descendants("class"));

El siguiente ejemplo muestra que el mtodo descendants() devuelve un objeto XMLList que contiene todos los objetos descendientes, incluidos los objetos secundarios, terciarios, etc.:
XML.ignoreComments = false; var xml:XML = <body> <!-- comment --> text1 <a> <b>text2</b>

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 </a> </body>; trace(xml.descendants("*").length()); // 5 trace(xml.descendants("*")[0]); // // <!-- comment --> trace(xml.descendants("*")[1].toXMLString()); // text1 trace(xml.descendants("a").toXMLString()); // <a><b>text2</b></a> trace(xml.descendants("b").toXMLString()); // <b>text2</b>

elements ()

mtodo

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

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Enumera los elementos de un objeto XML. Un elemento consta de una etiqueta inicial y otra final; por ejemplo, <first></first> . El parmetro name es opcional. El parmetro name puede ser un objeto QName, un tipo de datos String o cualquier otro tipo de datos que luego se convierte a un tipo de datos String. Utilice el parmetro name para enumerar un elemento concreto. Por ejemplo, el elemento " first " devuelve " John" en este ejemplo: <first>John</first> . Para enumerar todos los elementos, utilice el parmetro asterisco (*). El asterisco es tambin el parmetro predeterminado. Utilice el mtodo length() con el parmetro de asterisco para que en la salida se incluya el nmero total de elementos. Por ejemplo, numElement = addressbook.elements("*").length(). Parmetros
name:Object (default = * ) El nombre del elemento. El nombre de un elemento va entre parntesis angulares. Por ejemplo, " first " es el objeto name en este ejemplo: <first></first> .

Valor devuelto XMLList Un objeto XMLList con el contenido del elemento. El contenido del elemento queda entre las etiquetas inicial y final. Si utiliza el asterisco (*) para llamar a todos los elementos, se devolvern tanto las etiquetas del elemento como el contenido. Vase tambin XML.child() Clase XMLList XML.length() XML.attribute() Operador punto (.) de XML Objetos XML Ejemplo En el ejemplo siguiente, se muestra que el mtodo elements() devuelve slo una lista de elementos, no de comentarios, propiedades de texto o instrucciones de procesamiento:
var xml:XML = <foo> <!-- comment --> <?instruction ?> text <a>1</a> <b>2</b> </foo>; trace(xml.elements("*").length()); // 2 trace(xml.elements("*")[0].toXMLString()); // <a>1</a> trace(xml.elements("b").length()); // 1 trace(xml.elements("b")[0].toXMLString()); // <b>2</b>

elements() y no el operador punto (.) de XML, como se muestra en el siguiente ejemplo: var xml:XML = <student id="206">

Para devolver elementos con nombres que coincidan con palabras reservadas de ActionScript, utilice el mtodo

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 <class name="Trigonometry" /> <class name="Spanish 2" /> </student> trace(xml.elements("class"));

hasComplexContent ()

mtodo

AS3 function hasComplexContent():Boolean

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Comprueba si el objeto XML tiene un contenido complejo. Un objeto XML tiene contenido complejo si tiene elementos secundarios. Los objetos XML que representan atributos, comentarios, instrucciones de procesamiento y nodos de texto no tienen contenido complejo. Sin embargo, puede considerarse que un objeto que contains alguno de los elementos anteriores tiene contenido complejo (si el objeto tiene elementos secundarios). Valor devuelto Boolean Si el objeto XML tiene un contenido complejo, el valor es true; en caso contrario, el valor es false . Vase tambin XML.hasSimpleContent() Objetos XML Ejemplo El siguiente ejemplo muestra un objeto XML con una propiedad llamada a que tiene contenido simple y una propiedad llamada a que tiene contenido complejo:
var xml:XML = <foo> <a> text </a> <a> <b/> </a> </foo>; trace(xml.a[0].hasComplexContent()); // false trace(xml.a[1].hasComplexContent()); // true trace(xml.a[0].hasSimpleContent()); // true trace(xml.a[1].hasSimpleContent()); // false

hasOwnProperty ()

mtodo

AS3 function hasOwnProperty(p:String):Boolean

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Comprueba si el objeto tiene la propiedad especificada por el parmetro p . Parmetros
p:String La propiedad con la que se va a establecer la correspondencia.

Valor devuelto Boolean Si la propiedad existe, el valor es true; en caso contrario, el valor es false . Vase tambin Objetos XML Ejemplo En el ejemplo siguiente, se utiliza el mtodo hasOwnProperty() para garantizar que existe una propiedad (b ) antes de evaluar una expresin (b == "11") que utilice la propiedad:

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 var xml:XML = <foo> <a /> <a> <b>10</b> </a> <a> <b>11</b> </a> </foo>; trace(xml.a.(hasOwnProperty("b") && b == "11"));

Si la ltima lnea de este ejemplo fuese la que se indica a continuacin, Flash Player emitira una excepcin, ya que el primer elemento llamado a no tiene ninguna propiedad denominada b :
trace(xml.a.(b == "11"));

En el ejemplo siguiente, se utiliza el mtodo hasOwnProperty() para garantizar que existe una propiedad (item) antes de evaluar una expresin (item.contains("toothbrush") ) que utilice la propiedad:
var xml:XML = <orders> <order id='1'> <item>toothbrush</item> <item>toothpaste</item> </order> <order> <returnItem>shoe polish</returnItem> </order> </orders>; trace(xml.order.(hasOwnProperty("item") && item.contains("toothbrush")));

hasSimpleContent ()

mtodo

AS3 function hasSimpleContent():Boolean

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Comprueba si el objeto XML tiene un contenido simple. Un objeto XML tiene contenido simple si representa un nodo de texto, un nodo de atributo o un elemento XML que no tiene elementos secundarios. Los objetos XML que representan comentarios e instrucciones de procesamiento no tienen contenido simple. Valor devuelto Boolean Si el objeto XML tiene un contenido simple, el valor es true; en caso contrario, el valor es false . Vase tambin XML.hasComplexContent() Objetos XML Ejemplo El siguiente ejemplo muestra un objeto XML con una propiedad llamada a que tiene contenido simple y una propiedad llamada a que tiene contenido complejo:
var xml:XML = <foo> <a> text </a> <a> <b/> </a> </foo>; trace(xml.a[0].hasComplexContent()); // false trace(xml.a[1].hasComplexContent()); // true trace(xml.a[0].hasSimpleContent()); // true trace(xml.a[1].hasSimpleContent()); // false

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

inScopeNamespaces ()

mtodo

AS3 function inScopeNamespaces():Array

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Enumera los espacios de nombres para el objeto XML basndose en el elemento principal del objeto. Valor devuelto Array Una matriz de objetos Namespace. Vase tambin Objetos XML

insertChildAfter ()

mtodo

AS3 function insertChildAfter(child1:Object, child2:Object):*

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Introduce el parmetro child2 especificado tras el parmetro child1 en este objeto XML y devuelve el objeto resultante. Si el parmetro child1 es null, el mtodo introduce el contenido de child2 delante de todos los elementos secundarios del objeto XML (dicho de otro modo, detrs de ninguno ). Si se proporciona child1 pero no existe en el objeto XML, el objeto XML no se modifica y se devuelve undefined . Si llama a este mtodo en un elemento secundario XML que no es un elemento (texto, atributos, comentarios, pi, etc.), se devuelve undefined . Utilice el operador delete (XML) para eliminar nodos XML. Parmetros
child1:Object El objeto del objeto de origen que se introduce delante de child2 .

child2:Object El objeto que se va a introducir.

Valor devuelto * El objeto XML resultante o undefined . Vase tambin XML.insertChildBefore() Operador delete (XML) Objetos XML Construccin y transformacin de objetos XML Ejemplo Este ejemplo aade un nuevo elemento al final de los elementos secundarios de un objeto XML:
var xml:XML = <menu> <item>burger</item> <item>soda</item> </menu>; xml.insertChildAfter(xml.item[0], <saleItem>fries</saleItem>); trace(xml);

La salida de trace() es la siguiente:

<menu> <item>burger</item> <saleItem>fries</saleItem> <item>soda</item> </menu>

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

insertChildBefore ()

mtodo

AS3 function insertChildBefore(child1:Object, child2:Object):*

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Introduce el parmetro child2 especificado antes del parmetro child1 en este objeto XML y devuelve el objeto resultante. Si el parmetro child1 es null, el mtodo introduce el contenido de child2 delante de todos los elementos secundarios del objeto XML (dicho de otro modo, detrs de ninguno ). Si se proporciona child1 pero no existe en el objeto XML, el objeto XML no se modifica y se devuelve undefined . Si llama a este mtodo en un elemento secundario XML que no es un elemento (texto, atributos, comentarios, pi, etc.), se devuelve undefined . Utilice el operador delete (XML) para eliminar nodos XML. Parmetros
child1:Object El objeto del objeto de origen que se introduce detrs de child2 .

child2:Object El objeto que se va a introducir.

Valor devuelto * El objeto XML resultante o undefined . Vase tambin XML.insertChildAfter() Operador delete (XML) Objetos XML Construccin y transformacin de objetos XML Ejemplo Este ejemplo aade un nuevo elemento al final de los elementos secundarios de un objeto XML:
var xml:XML = <menu> <item>burger</item> <item>soda</item> </menu>; xml.insertChildBefore(xml.bar[0], <saleItem>fries</saleItem>); trace(xml);

La salida de trace() es la siguiente:

<menu> <saleItem>fries</saleItem> <item>burger</item> <item>soda</item> </menu>

length ()

mtodo

AS3 function length():int

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 En el caso de objetos XML, este mtodo siempre devuelve el entero 1 . El mtodo length() de la clase XMLList devuelve el valor 1 para un objeto XMLList que contiene un solo valor. Valor devuelto int Siempre devuelve 1 para cualquier objeto XML. Vase tambin Objetos XML

localName ()

mtodo

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 AS3 function localName():Object

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Proporciona la parte local del nombre completo del objeto XML. Valor devuelto Object El nombre local en forma de cadena (String) o null. Vase tambin Objetos XML Ejemplo El ejemplo siguiente demuestra cmo utilizar correctamente el mtodo localName() :
var xml:XML = <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"> <soap:Body xmlns:wx = "http://example.com/weather"> <wx:forecast> <wx:city>Quito</wx:city> </wx:forecast> </soap:Body> </soap:Envelope>; trace(xml.localName()); // Envelope

name ()

mtodo

AS3 function name():Object

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Proporciona el nombre completo del objeto XML. Valor devuelto Object El nombre completo es un QName o null. Vase tambin XML.attributes() identificador de atributos Objetos XML Ejemplo El siguiente ejemplo ilustra el uso del mtodo name() para obtener el nombre completo de un objeto XML:
var xml:XML = <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"> <soap:Body xmlns:wx = "http://example.com/weather"> <wx:forecast> <wx:city>Quito</wx:city> </wx:forecast> </soap:Body> </soap:Envelope>; trace(xml.name().localName); // Envelope trace(xml.name().uri); // "http://www.w3.org/2001/12/soap-envelope"

El siguiente ejemplo ilustra el uso del mtodo name() al que se llama en una propiedad XML, en un elemento de texto o en un atributo:

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 var xml:XML = <foo x="15" y="22"> text </foo>; trace(xml.name().localName); // foo trace(xml.name().uri == ""); // true trace(xml.children()[0]); // text trace(xml.children()[0].name()); // null trace(xml.attributes()[0]); // 15 trace(xml.attributes()[0].name()); // x

namespace ()

mtodo

AS3 function namespace(prefix:String = null):*

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Si no se especifica ningn parmetro, proporciona el espacio de nombres asociado al nombre completo de este objeto XML. Si se especifica un parmetro prefix , el mtodo devuelve el espacio de nombres que coincida con el parmetro prefix y est en el mbito del objeto XML. Si no existe el espacio de nombres en cuestin, el mtodo devuelve undefined . Parmetros
prefix:String (default = null) El prefijo con el que desea averiguar si hay coincidencias.

Valor devuelto * Devuelve null, undefined o un espacio de nombres. Vase tambin Objetos XML Ejemplo En el ejemplo siguiente, se utiliza el mtodo namespace() para obtener el espacio de nombres de un objeto XML y asignarlo a un objeto Namespace llamado soap que, despus, se utiliza para identificar una propiedad del objeto xml (xml.soap::Body[0]):
var xml:XML = <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"> <soap:Body xmlns:wx = "http://example.com/weather"> <wx:forecast> <wx:city>Quito</wx:city> </wx:forecast> </soap:Body> </soap:Envelope>; var soap:Namespace = xml.namespace(); trace(soap.prefix); // soap trace(soap.uri); // http://www.w3.org/2001/12/soap-envelope var body:XML = xml.soap::Body[0]; trace(body.namespace().prefix); // soap trace(xml.namespace().uri); // http://www.w3.org/2001/12/soap-envelope trace(body.namespace("wx").uri); // "http://example.com/weather"

En el ejemplo siguiente, se utiliza el mtodo namespace() para obtener el espacio de nombres predeterminado de un nodo, as como el espacio de nombres de un prefijo especfico ("dc"):
var xml:XML = <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns="http://purl.org/rss/1.0/"> <!--... --> </rdf:RDF>;

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

trace(xml.namespace()); // http://www.w3.org/1999/02/22-rdf-syntax-ns# trace(xml.namespace("dc")); // http://purl.org/dc/elements/1.1/ trace(xml.namespace("foo")); // undefined

namespaceDeclarations ()

mtodo

AS3 function namespaceDeclarations():Array

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Enumera las declaraciones de espacio de nombres asociadas al objeto XML en el contexto de su elemento principal. Valor devuelto Array Una matriz de objetos Namespace. Vase tambin XML.namespace() Objetos XML Ejemplo El siguiente ejemplo da como resultado las declaraciones de espacios de nombres de un objeto XML:
var xml:XML = <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns="http://purl.org/rss/1.0/"> <!--... --> </rdf:RDF>; for (var i:uint = 0; i < xml.namespaceDeclarations().length; i++) { var ns:Namespace = xml.namespaceDeclarations()[i]; var prefix:String = ns.prefix; if (prefix == "") { prefix = "(default)"; } trace(prefix + ":", ns.uri); }

La salida de trace() es la siguiente:

rdf: http://www.w3.org/1999/02/22-rdf-syntax-ns# dc: http://purl.org/dc/elements/1.1/ (default): http://purl.org/rss/1.0/

nodeKind ()

mtodo

AS3 function nodeKind():String

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Especifica el tipo de nodo: texto, comentario, instruccin de procesamiento, atributo o elemento. Valor devuelto String El tipo de nodo utilizado. Vase tambin identificador de atributos Objetos XML Ejemplo Este ejemplo muestra los cinco tipos de nodos:

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 XML.ignoreComments = false; XML.ignoreProcessingInstructions = false; var xml:XML = <example id="10"> <!-- this is a comment --> <?test this is a pi ?> and some text </example>; trace(xml.nodeKind()); // element trace(xml.children()[0].nodeKind()); // comment trace(xml.children()[1].nodeKind()); // processing-instruction trace(xml.children()[2].nodeKind()); // text trace(xml.@id[0].nodeKind()); // attribute

normalize ()

mtodo

AS3 function normalize():XML

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Para el objeto XML y todos los objetos XML descendientes, funde los nodos de texto adyacentes y elimina los nodos de texto vacos. Valor devuelto XML El objeto XML normalizado resultante. Vase tambin Objetos XML Ejemplo El ejemplo siguiente muestra el efecto que tiene llamar al mtodo normalize() :
var xml:XML = <body></body>; xml.appendChild("hello"); xml.appendChild(" world"); trace(xml.children().length()); // 2 xml.normalize(); trace(xml.children().length()); // 1

parent ()

mtodo

AS3 function parent():*

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Devuelve el elemento principal del objeto XML. Si el objeto XML carece de elemento principal, el mtodo devuelve undefined . Valor devuelto * El objeto XML principal. Devuelve una cadena String o null. Vase tambin Objetos XML Navegacin de estructuras XML Ejemplo En el ejemplo siguiente, se utiliza el mtodo parent() para identificar el elemento principal de un elemento concreto en una estructura XML:
var xml:XML = <body> <p id="p1">Hello</p>

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 <p id="p2">Test: <ul> <li>1</li> <li>2</li> </ul> </p> </body>; var node:XML = xml.p.ul.(li.contains("1"))[0]; // == <ul>... </ul> trace(node.parent().@id); // p2

prependChild ()

mtodo

AS3 function prependChild(value:Object):XML

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Introduce una copia del objeto child (secundario) proporcionado en el elemento XML delante de cualquier propiedad XML existente para dicho elemento. Utilice el operador delete (XML) para eliminar nodos XML. Parmetros
value:Object El objeto que se va a introducir.

Valor devuelto XML El objeto XML resultante. Vase tambin Operador delete (XML) Objetos XML Construccin y transformacin de objetos XML Ejemplo El siguiente ejemplo utiliza el mtodo prependChild() para aadir un elemento al principio de una lista de elementos secundarios en un objeto XML:
var xml:XML = <body> <p>hello</p> </body>; xml.prependChild(<p>world</p>); trace(xml.p[0].toXMLString()); // <p>world</p> trace(xml.p[1].toXMLString()); // <p>hello</p>

processingInstructions ()

mtodo

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

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Si se proporciona un parmetro name, enumera todos los elementos secundarios del objeto XML que contienen instrucciones de procesamiento con dicho nombre name. Si no hay parmetros, el mtodo enumera todos los elementos secundarios del objeto XML que contienen instrucciones de procesamiento. Parmetros
name:String (default = " * ") El nombre de las instrucciones de procesamiento con las que va a establecerse la correspondencia.

Valor devuelto XMLList Lista de objetos secundarios coincidentes. Vase tambin

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

Objetos XML Ejemplo El siguiente ejemplo utiliza el mtodo processingInstructions() para obtener una matriz de instrucciones de procesamiento para un objeto XML:
XML.ignoreProcessingInstructions = false; var xml:XML = <body> foo <?xml-stylesheet href="headlines.css" type="text/css" ?> <?instructionX ?> </body>; trace(xml.processingInstructions().length()); // 2 trace(xml.processingInstructions()[0].name()); // xml-stylesheet

propertyIsEnumerable ()

mtodo

AS3 function propertyIsEnumerable(p:String):Boolean

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Comprueba si la propiedad p est en el conjunto de propiedades que se pueden repetir en una sentencia for..in aplicada al objeto XML. Devuelve true slo si toString(p) == "0". Parmetros
p:String La propiedad que desea comprobar.

Valor devuelto Boolean Si la propiedad puede repetirse en una sentencia for..in, el valor es true; en caso contrario, es false . Vase tambin Objetos XML Ejemplo En el ejemplo siguiente, se muestra que para un objeto XML, el mtodo propertyNameIsEnumerable() devuelve un valor true nicamente para el valor 0 ; mientras que en un objeto XMLList object, el valor devuelto es true para cada valor de ndice vlido del objeto XMLList:
var xml:XML = <body> <p>Hello</p> <p>World</p> </body>; trace(xml.propertyIsEnumerable(0)); // true trace(xml.propertyIsEnumerable(1)); // false for (var propertyName:String in xml) { trace(xml[propertyName]); } var list:XMLList = xml.p; trace(list.propertyIsEnumerable(0)); // true trace(list.propertyIsEnumerable(1)); // true trace(list.propertyIsEnumerable(2)); // false for (var propertyName:String in list) { trace(list[propertyName]); }

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

removeNamespace ()

mtodo

AS3 function removeNamespace(ns:Namespace):XML

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Elimina el espacio de nombres proporcionado para este objeto y todos los descendientes. El mtodo removeNamespaces() no elimina un espacio de nombres si el nombre completo del objeto o el nombre completo de los atributos del objeto hacen referencia a l. Parmetros
ns:Namespace El espacio de nombres que se va a eliminar.

Valor devuelto XML Una copia del objeto XML resultante. Vase tambin Objetos XML Ejemplo El siguiente ejemplo muestra cmo eliminar una declaracin de espacio de nombres en un objeto XML:
var xml:XML = <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns="http://purl.org/rss/1.0/"> <!--... --> </rdf:RDF>; trace(xml.namespaceDeclarations().length); // 3 trace(xml.namespaceDeclarations()[0] is String); // var dc:Namespace = xml.namespace("dc"); xml.removeNamespace(dc); trace(xml.namespaceDeclarations().length); // 2

replace ()

mtodo

AS3 function replace(propertyName:Object, value:XML):XML

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Sustituye las propiedades especificadas mediante el parmetro propertyName por el parmetro value . Si no hay ninguna propiedad que coincida con propertyName, el objeto XML permanecer sin cambios. Parmetros
propertyName:Object Puede tratarse de un valor numrico, un nombre incompleto para un conjunto de

elementos XML, un nombre completo para un conjunto de elementos XML o el comodn de asterisco ("*"). Utilice un nombre incompleto para identificar elementos XML en el espacio de nombres predeterminado.

value:XML El valor de sustitucin. Puede ser un objeto XML, un objeto XMLList o cualquier valor que pueda convertirse con toString() .

Valor devuelto XML El objeto XML resultante, con las propiedades coincidentes sustituidas. Vase tambin Objetos XML Ejemplo El siguiente ejemplo ilustra la llamada al mtodo replace() con un entero como primer parmetro:
var xml:XML = <body>

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 <p>Hello</p> <p>World</p> <hr/> </body>; xml.replace(1, <p>Bob</p>); trace(xml);

Este cdigo da como resultado la salida trace() siguiente:

<body> <p>Hello</p> <p>Bob</p> <hr/> </body>

El siguiente ejemplo llama al mtodo replace() con una cadena como primer parmetro:
var xml:XML = <body> <p>Hello</p> <p>World</p> <hr/> </body>; xml.replace("p", <p>Hi</p>); trace(xml);

Este cdigo da como resultado la salida trace() siguiente:

<body> <p>Hi</p> <hr/> </body>;

El siguiente ejemplo ilustra la llamada al mtodo replace() con un objeto QName como primer parmetro:
var xml:XML = <ns:body xmlns:ns = "myNS"> <ns:p>Hello</ns:p> <ns:p>World</ns:p> <hr/> </ns:body>; var qname:QName = new QName("myNS", "p"); xml.replace(qname, <p>Bob</p>); trace(xml);

Este cdigo da como resultado la salida trace() siguiente:

<ns:body xmlns:ns = "myNS"> <p>Bob</p> <hr/> </ns:body>

El siguiente ejemplo ilustra la llamada al mtodo replace() con la cadena "*" como primer parmetro:
var xml:XML = <body> <p>Hello</p> <p>World</p> <hr/> </body>; xml.replace("*", <img src = "hello.jpg"/>); trace(xml);

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

Este cdigo da como resultado la salida trace() siguiente:

<body> <img src="hello.jpg"/> </body>

setChildren ()

mtodo

AS3 function setChildren(value:Object):XML

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Sustituye las propiedades secundarias del objeto XML por el conjunto especificado de propiedades XML, proporcionadas en el parmetro value . Parmetros
value:Object Las propiedades XML sustitutas. Puede ser un nico objeto XML o un objeto XMLList.

Valor devuelto XML El objeto XML resultante. Vase tambin Objetos XML Ejemplo El siguiente ejemplo ilustra la llamada al mtodo setChildren() utilizando primero un objeto XML como parmetro y, despus, utilizando como parmetro un objeto XMLList:
var xml:XML = <body> <p>Hello</p> <p>World</p> </body>; var list:XMLList = xml.p; xml.setChildren(<p>hello</p>); trace(xml); // // // <body> <p>hello</p> </body>

xml.setChildren(list); trace(xml); // // // // <body> <p>Hello</p> <p>World</p> </body>

setLocalName ()

mtodo

AS3 function setLocalName(name:String):void

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Cambia el nombre local del objeto XML al parmetro name especificado. Parmetros
name:String El nombre sustituto para el nombre local.

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

Vase tambin Objetos XML Ejemplo El siguiente ejemplo utiliza el mtodo setLocalName() para cambiar el nombre local de un elemento XML:
var xml:XML = <ns:item xmlns:ns="http://example.com"> toothbrush </ns:item>; xml.setLocalName("orderItem"); trace(xml.toXMLString()); // <ns:orderItem xmlns:ns="http://example.com">toothbrush</ns:orderItem>

setName ()

mtodo

AS3 function setName(name:String):void

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Establece el nombre del objeto XML con el nombre completo o nombre de atributo especificado. Parmetros
name:String El nuevo nombre del objeto.

Vase tambin Objetos XML Ejemplo El siguiente ejemplo utiliza el mtodo setName() para cambiar el nombre de un elemento XML:
var xml:XML = <item> toothbrush </item>; xml.setName("orderItem"); trace(xml.toXMLString()); // <orderItem>toothbrush</orderItem>

setNamespace ()

mtodo

AS3 function setNamespace(ns:Namespace):void

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Establece el espacio de nombres asociado al objeto XML. Parmetros
ns:Namespace El nuevo espacio de nombres.

Vase tambin Objetos XML Ejemplo En el ejemplo siguiente, se utiliza el espacio de nombres soap definido en un objeto XML y se aplica al espacio de nombres de otro objeto XML (xml2):
var xml1:XML = <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 <!--... --> </soap:Envelope>; var ns:Namespace = xml1.namespace("soap"); var xml2:XML = <Envelope> <Body/> </Envelope>; xml2.setNamespace(ns); trace(xml2);

setSettings ()

mtodo

AS3 static function setSettings(... rest):void

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Establece valores para las siguientes propiedades XML: ignoreComments , ignoreProcessingInstructions , ignoreWhitespace, prettyIndent y prettyPrinting . A continuacin se indica la configuracin predeterminada, que se aplica si no se proporciona ningn parmetro setObj :
XML.ignoreComments = true XML.ignoreProcessingInstructions = true XML.ignoreWhitespace = true XML.prettyIndent = 2 XML.prettyPrinting = true

Nota : este mtodo no se aplica a una instancia de la clase XML, sino que se aplica a XML, como en el siguiente cdigo: XML.setSettings(). Parmetros
... rest Un objeto con las propiedades siguientes: ignoreComments ignoreProcessingInstructions ignoreWhitespace prettyIndent prettyPrinting

Vase tambin ignoreComments ignoreProcessingInstructions ignoreWhitespace prettyIndent prettyPrinting defaultSettings() settings() Parmetros de funcin Objetos XML Ejemplo El ejemplo siguiente demuestra: cmo aplicar una configuracin personalizada (para incluir comentarios e instrucciones de procesamiento) antes de definir un objeto XML; cmo recuperar la configuracin predeterminada otra vez antes de definir otro objeto XML; y cmo definir la configuracin personalizada de nuevo (para seguir definiendo ms objetos XML):
XML.ignoreComments = false; XML.ignoreProcessingInstructions = false; var customSettings:Object = XML.settings(); var xml1:XML = <foo> <!-- comment --> <?instruction ?>

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 </foo>; trace(xml1.toXMLString()); // <foo> // <!-- comment --> // <?instruction ?> // </foo> XML.setSettings(XML.defaultSettings()); var xml2:XML = <foo> <!-- comment --> <?instruction ?> </foo>; trace(xml2.toXMLString());

settings ()

mtodo

AS3 static function settings():Object

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Recupera las siguientes propiedades: ignoreComments , ignoreProcessingInstructions , ignoreWhitespace, prettyIndent y prettyPrinting . Valor devuelto Object Un objeto con las propiedades XML siguientes:
ignoreComments ignoreProcessingInstructions ignoreWhitespace prettyIndent prettyPrinting

Vase tambin XML.ignoreComments XML.ignoreProcessingInstructions XML.ignoreWhitespace XML.prettyIndent XML.prettyPrinting XML.defaultSettings() XML.setSettings() Ejemplo El ejemplo siguiente demuestra: cmo aplicar una configuracin personalizada (para incluir comentarios e instrucciones de procesamiento) antes de definir un objeto XML; cmo recuperar la configuracin predeterminada otra vez antes de definir otro objeto XML; y cmo definir la configuracin personalizada de nuevo (para seguir definiendo ms objetos XML):
XML.ignoreComments = false; XML.ignoreProcessingInstructions = false; var customSettings:Object = XML.settings(); var xml1:XML = <foo> <!-- comment --> <?instruction ?> </foo>; trace(xml1.toXMLString()); // <foo> // <!-- comment --> // <?instruction ?> // </foo> XML.setSettings(XML.defaultSettings()); var xml2:XML = <foo> <!-- comment -->

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 <?instruction ?> </foo>; trace(xml2.toXMLString());

text ()

mtodo

AS3 function text():XMLList

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Devuelve un objeto XMLList con todas las propiedades XML del objeto XML que representan los nodos de texto XML. Valor devuelto XMLList La lista de propiedades. Vase tambin Objetos XML Ejemplo El siguiente ejemplo utiliza el mtodo text() para obtener los nodos de texto de un objeto XML:
var xml:XML = <body> text1 <hr/> text2 </body>; trace(xml.text()[0]); // text1 trace(xml.text()[1]); // text2

toString ()

mtodo

AS3 function toString():String

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Devuelve una representacin de cadena del objeto XML. Las reglas para esta conversin dependen de si el objeto XML tiene contenido simple o contenido complejo: Si el objeto XML tiene contenido simple, toString() devuelve el contenido de cadena del objeto XML con la siguiente informacin eliminada: la etiqueta inicial, los atributos, las declaraciones de espacio de nombres y la etiqueta final. Si el objeto XML tiene contenido complejo, toString() devuelve una cadena (String) con codificacin XML que representa al objeto XML completo, incluidos la etiqueta inicial, los atributos, las declaraciones de espacio de nombres y la etiqueta final. Para que se devuelva siempre el objeto XML completo, utilice toXMLString(). Valor devuelto String La representacin de cadena del objeto XML. Vase tambin XML.hasSimpleContent() XML.hasComplexContent() XML.toXMLString() Conversin de tipo XML Ejemplo El siguiente ejemplo muestra qu devuelve el mtodo toString() cuando el objeto XML tiene contenido simple:
var test:XML = <type name="Joe">example</type>; trace(test.toString()); //example

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

El siguiente ejemplo muestra qu devuelve el mtodo toString() cuando el objeto XML tiene contenido complejo:
var test:XML = <type name="Joe"> <base name="Bob"></base> example </type>; trace(test.toString()); // <type name="Joe"> // <base name="Bob"/> // example // </type>

toXMLString ()

mtodo

AS3 function toXMLString():String

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Devuelve una representacin de cadena del objeto XML. A diferencia del mtodo toString() , el mtodo toXMLString() siempre devuelve la etiqueta inicial, los atributos y la etiqueta final del objeto XML, con independencia de si el objeto XML tiene contenido simple o complejo. (El mtodo toString() elimina estos elementos en el caso de objetos XML que tienen contenido simple.) Valor devuelto String La representacin de cadena del objeto XML. Vase tambin XML.toString() Objetos XML Conversin de tipo XML Ejemplo El siguiente ejemplo muestra la diferencia entre utilizar el mtodo toString() (que se aplica a todos los parmetros de un mtodo trace() de forma predeterminada) y utilizar el mtodo toXMLString():
var xml:XML = <p>hello</p>; trace(xml); // hello trace(xml.toXMLString()); // <p>hello</p>

valueOf ()

mtodo

AS3 function valueOf():XML

Versin del lenguaje:ActionScript 3.0 Versin del reproductor:Flash Player 9 Devuelve el objeto XML. Valor devuelto XML El valor simple de una instancia XML. Vase tambin Objetos XML Ejemplo El siguiente ejemplo muestra que el valor devuelto por el mtodo valueOf() es el mismo que el objeto XML de origen:
var xml:XML = <p>hello</p>; trace(xml.valueOf() === xml); // true

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0

Ejemplos Cmo utilizar los ejemplos

XMLExample.as El siguiente ejemplo primero crea una variable XML y luego le aade nodos. Las propiedades XML se utilizan para buscar e imprimir nodos XML. Observe que el smbolo "arroba" (@ ) se utiliza en varias de las llamadas a trace() para localizar la informacin por nombre de atributo.
package { import flash.display.Sprite; public class XmlExample extends Sprite { public function XmlExample() { var employees:XML = <employees> <employee ssn="123-123-1234"> <name first="John" last="Doe"/> <address> <street>11 Main St.</street> <city>San Francisco</city> <state>CA</state> <zip>98765</zip> </address> </employee> <employee ssn="789-789-7890"> <name first="Mary" last="Roe"/> <address> <street>99 Broad St.</street> <city>Newton</city> <state>MA</state> <zip>01234</zip> </address> </employee> </employees>; trace(employees.employee[0].address.zip); trace(employees.employee[1].@ssn); trace(employees.employee.name); trace(employees..zip[0]); trace(employees..@ssn[1]); trace(employees..name); trace(employees.employee[0].address.*); // 98765 // 789-789-7890 // <name first="John" last="Doe"/> // <name first="Mary" last="Roe"/> // 98765 // 789-789-7890 // <name first="John" last="Doe"/> // <name first="Mary" last="Roe"/> // <street>11 Main St.</street> // <city>San Francisco</city> // <state>CA</state> // <zip>98765</zip>

var node:String = "zip"; trace(employees.employee[0].address[node]); // 98765 var attribute:String = "ssn"; trace(employees.employee[1].@[attribute]); // 789-789-7890

for each (var num:XML in employees..@ssn) { trace(num); // 123-123-1234 } // 789-789-7890 var ssnToFind:String = "789-789-7890"; trace(employees.employee.(@ssn == ssnToFind).toXMLString()); // <employee ssn="789-789-7890"> // <name first="Mary" last="Roe"/>

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]

XML - Referencia del lenguaje y componentes ActionScript 3.0 // // // // // // // } } } <address> <street>99 Broad St.</street> <city>Newton</city> <state>MA</state> <zip>01234</zip> </address> </employee>

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XML.html[25/10/2010 23:20:30]