xml - referencia del lenguaje y componentes actionscript 3.0

XML - Referencia del lenguaje y componentes ActionScript 3.0

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

Paquete Nivel superiorClase public final dynamic class XMLHerencia XML Object

Versión del lenguaje: ActionScript 3.0Versión del reproductor: Flash Player 9

La clase XML contiene métodos y propiedades para trabajar con objetos XML. La clase XML (junto con las clases XMLList,Namespace y QName) implementa potentes normas de gestión de XML definidas en la especificación ECMAScript para XML(E4X) (ECMA-357 edición 2).

Utilice el método toXMLString() para que se devuelva una representación de cadena del objeto XML, con independencia desi 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 hatrasladado al paquete flash.xml. Se incluye en ActionScript 3.0 para conseguir compatibilidad retroactiva.

Ver los ejemplos

Véase tambiénNamespace QName XMLList XML.toXMLString() Especificación ECMAScript para XML (E4X) (ECMA-357; edición 2) Objetos XML

Propiedades públicas Mostrar propiedades públicas heredadas

Propiedad Definido por

ignoreComments : Boolean[static] Determina si los comentarios XML se ignoran cuando los objetos XML analizan los datos XMLde origen.

XML

ignoreProcessingInstructions : Boolean[static] Determina si las instrucciones de procesamiento XML se ignoran cuando los objetos XMLanalizan los datos XML de origen.

XML

ignoreWhitespace : Boolean[static] Determina si los caracteres de espacio en blanco situados al comienzo y al final de los nodosde texto deben ignorarse durante el análisis.

XML

prettyIndent : int[static] Determina la cantidad de sangría que se aplica a los métodos toString() y toXMLString()cuando la propiedad XML.prettyPrinting se establece con el valor true.

XML

prettyPrinting : Boolean[static] Determina si los métodos toString() y toXMLString() normalizan los caracteres de espacio enblanco existentes entre algunas etiquetas.

XML

Métodos públicos Mostrar métodos públicos heredados

Método Definido por

XML(value:Object)Crea un nuevo objeto XML.

XML

addNamespace(ns:Object):XMLAñade un espacio de nombres al conjunto de espacios de nombres del ámbito para el objeto XML.

XML

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/package-detail.html

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/Object.html

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/Namespace.html

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/QName.html

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XMLList.html

http://www.ecma-international.org/publications/standards/Ecma-357.htm

http://livedocs.adobe.com/flash/9.0_es/main/00000125.html

http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/Boolean.html



http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/int.html






appendChild(child:Object):XMLAñade el elemento secundario en cuestión al final de las propiedades del objeto XML.

XML

attribute(attributeName:*):XMLListDevuelve el valor XML del atributo cuyo nombre coincide con el parámetro attributeName.

XML

attributes():XMLListDevuelve una lista de valores de atributos para el objeto XML en cuestión.

XML

child(propertyName:Object):XMLListEnumera los elementos secundarios de un objeto XML.

XML

childIndex():intIdentifica la posición de índice basada en cero de este objeto XML dentro del contexto de suelemento principal.

XML

children():XMLListEnumera los elementos secundarios del objeto XML en la secuencia en que aparecen.

XML

comments():XMLListEnumera las propiedades del objeto XML que contienen comentarios XML.

XML

contains(value:XML):BooleanCompara el objeto XML con el parámetro value especificado.

XML

copy():XMLDevuelve una copia del objeto XML en cuestión.

XML

defaultSettings():Object[static] Devuelve un objeto con las siguientes propiedades configuradas con los valorespredeterminados: ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent yprettyPrinting.

XML

descendants(name:Object = *):XMLListDevuelve todos los descendientes (elementos secundarios, terciarios, cuaternarios, etc.) del objetoXML que tiene el parámetro name.

XML

elements(name:Object = *):XMLListEnumera los elementos de un objeto XML.

XML

hasComplexContent():BooleanComprueba si el objeto XML tiene un contenido complejo.

XML

hasOwnProperty(p:String):BooleanComprueba si el objeto tiene la propiedad especificada por el parámetro p.

XML

hasSimpleContent():BooleanComprueba si el objeto XML tiene un contenido simple.

XML

inScopeNamespaces():ArrayEnumera los espacios de nombres para el objeto XML basándose en el elemento principal del objeto.

XML

insertChildAfter(child1:Object, child2:Object):*Introduce el parámetro child2 especificado tras el parámetro child1 en este objeto XML y devuelve elobjeto resultante.

XML

insertChildBefore(child1:Object, child2:Object):*Introduce el parámetro child2 especificado delante del parámetro child1 en este objeto XML ydevuelve el objeto resultante.

XML

length():intEn el caso de objetos XML, este método siempre devuelve el entero 1.

XML

localName():ObjectProporciona la parte local del nombre completo del objeto XML.

XML

name():ObjectProporciona el nombre completo del objeto XML.

XML

namespace(prefix:String = null):*Si no se especifica ningún parámetro, proporciona el espacio de nombres asociado al nombrecompleto de este objeto XML.

XML

namespaceDeclarations():ArrayEnumera las declaraciones de espacio de nombres asociadas al objeto XML en el contexto de suelemento principal.

XML

nodeKind():StringEspecifica el tipo de nodo: texto, comentario, instrucción de procesamiento, atributo o elemento.

XML

normalize():XMLPara el objeto XML y todos los objetos XML descendientes, funde los nodos de texto adyacentes y

XML


http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/specialTypes.html#*















http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/String.html



http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/Array.html
















elimina los nodos de texto vacíos.

parent():*Devuelve el elemento principal del objeto XML.

XML

prependChild(value:Object):XMLIntroduce una copia del objeto child (secundario) proporcionado en el elemento XML delante decualquier propiedad XML existente para dicho elemento.

XML

processingInstructions(name:String = "*"):XMLListSi se proporciona un parámetro name, enumera todos los elementos secundarios del objeto XML quecontienen instrucciones de procesamiento con dicho nombre.

XML

propertyIsEnumerable(p:String):BooleanComprueba si la propiedad p está en el conjunto de propiedades que se pueden repetir en unasentencia for..in aplicada al objeto XML.

XML

removeNamespace(ns:Namespace):XMLElimina el espacio de nombres proporcionado para este objeto y todos los descendientes.

XML

replace(propertyName:Object, value:XML):XMLSustituye las propiedades especificadas mediante el parámetro propertyName por el parámetro valueen cuestión.

XML

setChildren(value:Object):XMLSustituye las propiedades secundarias del objeto XML por el conjunto especificado de propiedadesXML, proporcionadas en el parámetro value.

XML

setLocalName(name:String):voidCambia el nombre local del objeto XML al parámetro name especificado.

XML

setName(name:String):voidEstablece el nombre del objeto XML con el nombre completo o nombre de atributo especificado.

XML

setNamespace(ns:Namespace):voidEstablece el espacio de nombres asociado al objeto XML.

XML

setSettings(... rest):void[static] Establece valores para las siguientes propiedades XML: ignoreComments,ignoreProcessingInstructions, ignoreWhitespace, prettyIndent y prettyPrinting.

XML

settings():Object[static] Recupera las siguientes propiedades: ignoreComments, ignoreProcessingInstructions,ignoreWhitespace, prettyIndent y prettyPrinting.

XML

text():XMLListDevuelve un objeto XMLList con todas las propiedades XML del objeto XML que representan los nodosde texto XML.

XML

toString():StringDevuelve una representación de cadena del objeto XML.

XML

toXMLString():StringDevuelve una representación de cadena del objeto XML.

XML

valueOf():XMLDevuelve el objeto XML.

XML

Información sobre propiedades

ignoreComments propiedadignoreComments:Boolean [read-write]


Determina si los comentarios XML se ignoran cuando los objetos XML analizan los datos XML de origen. De formapredeterminada, los comentarios se ignoran (true). Para incluir comentarios XML, establezca esta propiedad con elvalor false. La propiedad ignoreComments sólo se utiliza durante el análisis XML, no durante la llamada a métodostales como myXMLObject.child(*).toXMLString(). Si el XML de origen incluye nodos de comentarios, éstos semantendrán o se eliminarán durante el análisis XML.

Implementación











http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/specialTypes.html#void





http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/statements.html#..._(rest)_parameter







public static function get ignoreComments():Boolean public function set ignoreComments(value:Boolean):void

Véase tambiénXML.child() XML.toXMLString()

Ejemplo

Este ejemplo muestra el efecto que tiene definir XML.ignoreComments como false y como true:

ignoreProcessingInstructions propiedad ignoreProcessingInstructions:Boolean [read-write]


Determina si las instrucciones de procesamiento XML se ignoran cuando los objetos XML analizan los datos XML deorigen. De forma predeterminada, las instrucciones de procesamiento se ignoran (true). Para incluir instrucciones deprocesamiento XML, establezca esta propiedad con el valor false. La propiedad ignoreProcessingInstructions sólose utiliza durante el análisis XML, no durante la llamada a métodos tales comomyXMLObject.child(*).toXMLString(). Si el XML de origen incluye nodos de instrucciones de procesamiento, éstosse mantendrán o se eliminarán durante el análisis XML.

Implementación public static function get ignoreProcessingInstructions():Boolean public function set ignoreProcessingInstructions(value:Boolean):void

Véase tambiénXML.child() XML.toXMLString()

Ejemplo

Este ejemplo muestra el efecto que tiene definir XML.ignoreProcessingInstructions como false y comotrue:

XML.ignoreComments = false;var xml1:XML = <foo>  </foo>;trace(xml1.toXMLString()); // <foo></foo>

XML.ignoreComments = true;var xml2:XML = <foo>  </foo>;trace(xml2.toXMLString()); // <foo/>

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/>

ignoreWhitespace propiedad ignoreWhitespace:Boolean [read-write]


Determina si los caracteres de espacio en blanco situados al comienzo y al final de los nodos de texto deben ignorarsedurante el análisis. De manera predeterminada, el espacio en blanco se ignora (true). Si un nodo de texto es espacioen blanco al 100% y la propiedad ignoreWhitespace se define en el valor true, el nodo no se creará. Para mostrar elespacio en blanco en un nodo de texto, defina la propiedad ignoreWhitespace con el valor false.

Implementación 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:

prettyIndent propiedad prettyIndent:int [read-write]


Determina la cantidad de sangría que se aplica a los métodos toString() y toXMLString() cuando la propiedadXML.prettyPrinting se define con el valor true. La sangría se aplica con el carácter de espacio, no con el carácterde tabulador. El valor predeterminado es 2.

Implementación public static function get prettyIndent():int public function set prettyIndent(value:int):void

Véase tambiénprettyPrinting toString() toXMLString()

Ejemplo

Este ejemplo muestra el efecto que tiene definir la propiedad estática XML.prettyIndent:

prettyPrinting propiedad prettyPrinting:Boolean [read-write]

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

var xml:XML = <foo><bar/></foo>;XML.prettyIndent = 0;trace(xml.toXMLString());

XML.prettyIndent = 1;trace(xml.toXMLString());

XML.prettyIndent = 2;trace(xml.toXMLString());

Determina si los métodos toString() y toXMLString() normalizan los caracteres de espacio en blanco existentesentre algunas etiquetas. El valor predeterminado es true.

Implementación public static function get prettyPrinting():Boolean public function set prettyPrinting(value:Boolean):void

Véase tambiénprettyIndent toString() toXMLString()

Ejemplo

Este ejemplo muestra el efecto que tiene definir la propiedad estática XML.prettyPrinting:

Información sobre constructores

XML() constructor

public function XML(value:Object)


Crea un nuevo objeto XML. Deberá utilizar el constructor para crear un objeto XML antes de llamar a cualquiera de losmétodos de la clase XML.

Utilice el método toXMLString() para que se devuelva una representación de cadena del objeto XML, conindependencia de si el objeto XML tiene contenido simple o complejo.

Parámetrosvalue:Object — Cualquier objeto que pueda convertirse a XML con la función XML() de nivel superior.

Véase tambiénFunción XML() de nivel superior XML.toXMLString() Objetos XML

Información sobre métodos

addNamespace() método

AS3 function addNamespace(ns:Object):XML


Añade un espacio de nombres al conjunto de espacios de nombres del ámbito para el objeto XML. Si el espacio de

var xml:XML = <foo><bar/></foo>;XML.prettyPrinting = false;trace(xml.toXMLString());

XML.prettyPrinting = true;trace(xml.toXMLString());






http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/package.html#XML()


http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/statements.html#AS3

nombres ya existe en los espacios de nombres del ámbito para el objeto XML (con un prefijo que coincide con el delparámetro especificado), el prefijo del espacio de nombres existente se establece en undefined. Si el parámetro deentrada es un objeto Namespace, éste se utiliza directamente. Si es un objeto QName, el URI del parámetro de entradase utiliza para crear un nuevo espacio de nombres; en caso contrario, se convierte a una cadena y se crea un espaciode nombres a partir de la cadena.

Parámetros

ns:Object — El espacio de nombres que se va a añadir al objeto XML.

Valor devueltoXML — El nuevo objeto XML con el espacio de nombres añadido.

Véase tambiénObjetos XML

Ejemplo

Este ejemplo utiliza un espacio de nombres definido en un objeto XML y lo aplica a otro objeto XML:

appendChild() método AS3 function appendChild(child:Object):XML


Añade el elemento secundario en cuestión al final de las propiedades del objeto XML. El método appendChild() tomaun 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.

Parámetros

child:Object — El objeto XML que se va a añadir.

Valor devueltoXML — El objeto XML resultante.

Véase tambiénOperador delete (XML) El enfoque E4X del procesamiento de XML Objetos XML Construcción y transformación de objetos XML

Ejemplo

Este ejemplo añade un nuevo elemento al final de la lista de elementos secundarios de un objeto XML:

attribute() método AS3 function attribute(attributeName:*):XMLList

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"/>

var xml:XML = <body> hello </body>;

xml.appendChild(world);trace(xml.p[0].toXMLString()); // hellotrace(xml.p[1].toXMLString()); // world






http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/operators.html#delete_(XML)

Devuelve el valor XML del atributo cuyo nombre coincide con el parámetro attributeName. Los atributos se encuentrandentro 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 parámetro attributeName puede tener cualquier tipo de datos; sin embargo, el tipo de datos que suele utilizarse esString. Al pasar cualquier objeto que no sea un objeto QName, el parámetro attributeName utiliza el métodotoString() para convertir el parámetro en una cadena.

Si necesita una referencia de nombre completa, puede pasar un objeto QName. Un objeto QName define un espacio denombre y el nombre local, que puede utilizar para definir el nombre completo de un atributo. Por consiguiente, llamar aattribute(qname) no es lo mismo que llamar a attribute(qname.toString()).

Parámetros

attributeName:* — El nombre del atributo.

Valor devueltoXMLList — Un objeto XMLList o un objeto XMLList vacío. Devuelve un objeto XMLList vacío si no se ha definido unvalor de atributo.

Véase tambiénXML.attributes() QName Namespace XML.elements() Operador de identificador de atributo (@) Objetos XML Navegación de estructuras XML

Ejemplo

Este ejemplo muestra un objeto QName transferido al método attribute(). La propiedad localName es attr yla propiedad namespace es ns.

Para devolver un atributo con un nombre que coincida con una palabra clave de ActionScript, utilice el métodoattribute() y no el operador de identificador de atributos (@), tal como se indica en el ejemplo siguiente:

attributes() método AS3 function attributes():XMLList


Devuelve una lista de valores de atributos para el objeto XML en cuestión. Utilice el método name() con el métodoattributes() para que se devuelva el nombre de un atributo. Utilice @* para que se devuelvan los nombres de todoslos atributos.

Valor devueltoXMLList — La lista de valores de atributos.

Véase tambiénXML.attribute() XML.name() Operador @ Objetos XML

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

var xml:XML = <example class="first" />trace(xml.attribute("class"));



http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/QName.html


http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/operators.html#attribute_identifier

Navegación de estructuras XML

Ejemplo

El siguiente ejemplo devuelve el nombre del atributo:

Este ejemplo devuelve los nombres de todos los atributos:

child() método AS3 function child(propertyName:Object):XMLList


Enumera los elementos secundarios de un objeto XML. Un elemento secundario XML es un elemento XML, un nodo detexto, un comentario o una instrucción de procesamiento.

Utilice el parámetro 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"). Puedegenerar el mismo resultado utilizando el número de índice del elemento secundario. El número de índice identifica laposición del elemento secundario en la lista de otros elementos secundarios XML. Por ejemplo, name.child(0) devuelveel primer elemento secundario de una lista.

Utilice un asterisco (*) para que en la salida se incluyan todos los elementos secundarios de un documento XML. Porejemplo, doc.child("*").

Utilice el método length() con el parámetro de asterisco (*) del método child() para que en la salida se incluya elnúmero total de elementos secundarios. Por ejemplo, numChildren = doc.child("*").length().

Parámetros

propertyName:Object — El nombre del elemento o el entero del elemento secundario XML.

Valor devueltoXMLList — Un objeto XMLList de nodos secundarios que coinciden con el parámetro de entrada.

Véase tambiénXML.elements() Clase XMLList XML.length() Objetos XML Navegación de estructuras XML

Ejemplo

Este ejemplo ilustra el uso del método child() para identificar elementos secundarios con un nombreespecificado:

var xml:XML=<example id='123' color='blue'/>trace(xml.attributes()[1].name()); //color

var xml:XML = <example id='123' color='blue'/>var attNamesList:XMLList = xml.@*;

trace(attNamesList is XMLList); // truetrace(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}

var xml:XML = <foo> <bar>text1</bar>

childIndex() método AS3 function childIndex():int


Identifica la posición de índice basada en cero de este objeto XML dentro del contexto de su elemento principal.

Valor devueltoint — La posición del objeto. Devuelve -1 además de enteros positivos.


Ejemplo

Este ejemplo muestra el uso del método childIndex():

children() método AS3 function children():XMLList


Enumera los elementos secundarios del objeto XML en la secuencia en que aparecen. Un elemento secundario XML esun elemento XML, un nodo de texto, un comentario o una instrucción de procesamiento.

Valor devueltoXMLList — Un objeto XMLList de los elementos secundarios del objeto XML.


Ejemplo

Este ejemplo muestra el uso del método children():

<bar>text2</bar> </foo>;trace(xml.child("bar").length()); // 2trace(xml.child("bar")[0].toXMLString()); // <bar>text1</bar>trace(xml.child("bar")[1].toXMLString()); // <bar>text2</bar>

var xml:XML = <foo> <bar /> text <bob /> </foo>;trace(xml.bar.childIndex()); // 0trace(xml.bob.childIndex()); // 2

XML.ignoreComments = false;XML.ignoreProcessingInstructions = false;var xml:XML = <foo id="22"> <bar>44</bar> text  <?instruction ?> </foo>;trace(xml.children().length()); // 4trace(xml.children()[0].toXMLString()); // <bar>44</bar>trace(xml.children()[1].toXMLString()); // texttrace(xml.children()[2].toXMLString()); // trace(xml.children()[3].toXMLString()); // <?instruction ?>

comments() método AS3 function comments():XMLList


Enumera las propiedades del objeto XML que contienen comentarios XML.

Valor devueltoXMLList — Un objeto XMLList de las propiedades que contienen comentarios.


Ejemplo

Este ejemplo muestra el uso del método comments():

contains() método AS3 function contains(value:XML):Boolean


Compara el objeto XML con el parámetro value especificado.

Parámetros

value:XML — Un valor que se va a comparar con el objeto XML actual.

Valor devueltoBoolean — Si el objeto XML coincide con el parámetro value, el valor es true; en caso contrario, el valor esfalse.


Ejemplo

Este ejemplo muestra el uso del método contains():

copy() método AS3 function copy():XML

Versión del lenguaje: ActionScript 3.0

XML.ignoreComments = false;var xml:XML = <foo>   </foo>;trace(xml.comments().length()); // 2trace(xml.comments()[1].toXMLString()); // 

var xml:XML = <order> <item>Rice</item> <item>Kung Pao Shrimp</item> </order>;trace(xml.item[0].contains(<item>Rice</item>)); // truetrace(xml.item[1].contains(<item>Kung Pao Shrimp</item>)); // truetrace(xml.item[1].contains(<item>MSG</item>)); // false

Versión del reproductor: Flash Player 9

Devuelve una copia del objeto XML en cuestión. La copia es un duplicado de todo el árbol de nodos. El objeto XMLcopiado no tiene elemento principal y devuelve null si intenta llamar al método parent().

Valor devueltoXML — La copia del objeto.


Ejemplo

Este ejemplo muestra que el método copy() crea una nueva instancia de un objeto XML. Al modificar la copia, eloriginal permanece intacto:

defaultSettings() método AS3 static function defaultSettings():Object


Devuelve un objeto con las siguientes propiedades configuradas con los valores predeterminados: ignoreComments,ignoreProcessingInstructions, ignoreWhitespace, prettyIndent y prettyPrinting. Los valorespredeterminados son los siguientes:

ignoreComments = trueignoreProcessingInstructions = trueignoreWhitespace = trueprettyIndent = 2prettyPrinting = true

Nota: este método no se aplica a una instancia de la clase XML, sino que se aplica a XML, como en el siguiente código:var df:Object = XML.defaultSettings().

Valor devueltoObject — Un objeto con propiedades configuradas con los valores predeterminados.

Véase tambiénXML.ignoreComments XML.ignoreProcessingInstructions XML.ignoreWhitespace XML.prettyIndent XML.prettyPrinting XML.setSettings() XML.settings() Objetos XML

Ejemplo

El ejemplo siguiente demuestra: cómo aplicar una configuración personalizada (para incluir comentarios einstrucciones de procesamiento) antes de definir un objeto XML; cómo recuperar la configuración predeterminadaotra vez antes de definir otro objeto XML; y cómo definir la configuración personalizada de nuevo (para seguirdefiniendo más objetos XML):

var xml1:XML = <foo />;var xml2:XML = xml1.copy();xml2.appendChild(<bar />);trace(xml1.bar.length()); // 0trace(xml2.bar.length()); // 1

XML.ignoreComments = false;XML.ignoreProcessingInstructions = false;var customSettings:Object = XML.settings();

var xml1:XML = <foo>

descendants() método AS3 function descendants(name:Object = *):XMLList


Devuelve todos los descendientes (elementos secundarios, terciarios, cuaternarios, etc.) del objeto XML que tiene elparámetro name. El parámetro name es opcional. El parámetro name puede ser un objeto QName, un tipo de datosString o cualquier otro tipo de datos que luego se convierte a un tipo de datos String.

Para devolver todos los descendientes, utilice el parámetro "*". Si no se pasa ningún parámetro, se pasa la cadena "*" yse devuelven todos los descendientes del objeto XML.

Parámetros

name:Object (default = *) — El nombre del elemento con el que va a establecerse la correspondencia.

Valor devueltoXMLList — Un objeto XMLList con los descendientes coincidentes. Si no hay descendientes, devuelve un objetoXMLList vacío.

Véase tambiénOperador descendant accessor (..) (..)

Ejemplo

Para devolver descendientes con nombres que coincidan con palabras reservadas de ActionScript, utilice elmétodo descendants() y no el operador descendant (..), como se muestra en el siguiente ejemplo:

El siguiente ejemplo muestra que el método descendants() devuelve un objeto XMLList que contiene todos losobjetos descendientes, incluidos los objetos secundarios, terciarios, etc.:

<?instruction ?> </foo>;trace(xml1.toXMLString());// <foo>// // <?instruction ?>// </foo>

XML.setSettings(XML.defaultSettings());var xml2:XML = <foo>  <?instruction ?> </foo>;trace(xml2.toXMLString());

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"));

XML.ignoreComments = false;var xml:XML = <body>  text1 <a> text2






http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/operators.html#descendant_accessor

elements() método AS3 function elements(name:Object = *):XMLList


Enumera los elementos de un objeto XML. Un elemento consta de una etiqueta inicial y otra final; por ejemplo,<first></first>. El parámetro name es opcional. El parámetro name puede ser un objeto QName, un tipo de datosString o cualquier otro tipo de datos que luego se convierte a un tipo de datos String. Utilice el parámetro name paraenumerar un elemento concreto. Por ejemplo, el elemento "first" devuelve "John" en este ejemplo:<first>John</first>.

Para enumerar todos los elementos, utilice el parámetro asterisco (*). El asterisco es también el parámetropredeterminado.

Utilice el método length() con el parámetro de asterisco para que en la salida se incluya el número total deelementos. Por ejemplo, numElement = addressbook.elements("*").length().

Parámetros

name:Object (default = *) — El nombre del elemento. El nombre de un elemento va entre paréntesis angulares.Por ejemplo, "first" es el objeto name en este ejemplo: <first></first>.

Valor devueltoXMLList — Un objeto XMLList con el contenido del elemento. El contenido del elemento queda entre las etiquetasinicial y final. Si utiliza el asterisco (*) para llamar a todos los elementos, se devolverán tanto las etiquetas delelemento como el contenido.

Véase tambiénXML.child() Clase XMLList XML.length() XML.attribute() Operador punto (.) de XML Objetos XML

Ejemplo

En el ejemplo siguiente, se muestra que el método elements() devuelve sólo una lista de elementos, no decomentarios, propiedades de texto o instrucciones de procesamiento:

Para devolver elementos con nombres que coincidan con palabras reservadas de ActionScript, utilice el métodoelements() y no el operador punto (.) de XML, como se muestra en el siguiente ejemplo:

</a> </body>;trace(xml.descendants("*").length()); // 5trace(xml.descendants("*")[0]); // // trace(xml.descendants("*")[1].toXMLString()); // text1trace(xml.descendants("a").toXMLString()); // <a>text2</a>trace(xml.descendants("b").toXMLString()); // text2

var xml:XML = <foo>  <?instruction ?> text <a>1</a> 2 </foo>;trace(xml.elements("*").length()); // 2trace(xml.elements("*")[0].toXMLString()); // <a>1</a>trace(xml.elements("b").length()); // 1trace(xml.elements("b")[0].toXMLString()); // 2

var xml:XML = <student id="206">







http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/operators.html#dot_(XML)

hasComplexContent() método AS3 function hasComplexContent():Boolean


Comprueba si el objeto XML tiene un contenido complejo. Un objeto XML tiene contenido complejo si tiene elementossecundarios. Los objetos XML que representan atributos, comentarios, instrucciones de procesamiento y nodos de textono tienen contenido complejo. Sin embargo, puede considerarse que un objeto que contains alguno de los elementosanteriores tiene contenido complejo (si el objeto tiene elementos secundarios).

Valor devueltoBoolean — Si el objeto XML tiene un contenido complejo, el valor es true; en caso contrario, el valor es false.

Véase tambiénXML.hasSimpleContent() Objetos XML

Ejemplo

El siguiente ejemplo muestra un objeto XML con una propiedad llamada a que tiene contenido simple y unapropiedad llamada a que tiene contenido complejo:

hasOwnProperty() método AS3 function hasOwnProperty(p:String):Boolean


Comprueba si el objeto tiene la propiedad especificada por el parámetro p.

Parámetros

p:String — La propiedad con la que se va a establecer la correspondencia.

Valor devueltoBoolean — Si la propiedad existe, el valor es true; en caso contrario, el valor es false.


Ejemplo

En el ejemplo siguiente, se utiliza el método hasOwnProperty() para garantizar que existe una propiedad (b)antes de evaluar una expresión (b == "11") que utilice la propiedad:

<class name="Trigonometry" /> <class name="Spanish 2" /> </student>trace(xml.elements("class"));

var xml:XML = <foo> <a> text </a> <a> </a> </foo>;trace(xml.a[0].hasComplexContent()); // falsetrace(xml.a[1].hasComplexContent()); // true

trace(xml.a[0].hasSimpleContent()); // truetrace(xml.a[1].hasSimpleContent()); // false

Si la última línea de este ejemplo fuese la que se indica a continuación, Flash Player emitiría una excepción, yaque el primer elemento llamado a no tiene ninguna propiedad denominada b:

trace(xml.a.(b == "11"));

En el ejemplo siguiente, se utiliza el método hasOwnProperty() para garantizar que existe una propiedad (item)antes de evaluar una expresión (item.contains("toothbrush")) que utilice la propiedad:

hasSimpleContent() método AS3 function hasSimpleContent():Boolean


Comprueba si el objeto XML tiene un contenido simple. Un objeto XML tiene contenido simple si representa un nodo detexto, un nodo de atributo o un elemento XML que no tiene elementos secundarios. Los objetos XML que representancomentarios e instrucciones de procesamiento no tienen contenido simple.

Valor devueltoBoolean — Si el objeto XML tiene un contenido simple, el valor es true; en caso contrario, el valor es false.

Véase tambiénXML.hasComplexContent() Objetos XML

Ejemplo

El siguiente ejemplo muestra un objeto XML con una propiedad llamada a que tiene contenido simple y unapropiedad llamada a que tiene contenido complejo:

var xml:XML = <foo> <a /> <a> 10 </a> <a> 11 </a> </foo>;trace(xml.a.(hasOwnProperty("b") && b == "11"));

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")));

var xml:XML = <foo> <a> text </a> <a> </a> </foo>;trace(xml.a[0].hasComplexContent()); // falsetrace(xml.a[1].hasComplexContent()); // true

trace(xml.a[0].hasSimpleContent()); // truetrace(xml.a[1].hasSimpleContent()); // false

inScopeNamespaces() método AS3 function inScopeNamespaces():Array


Enumera los espacios de nombres para el objeto XML basándose en el elemento principal del objeto.

Valor devueltoArray — Una matriz de objetos Namespace.


insertChildAfter() método AS3 function insertChildAfter(child1:Object, child2:Object):*


Introduce el parámetro child2 especificado tras el parámetro child1 en este objeto XML y devuelve el objetoresultante. Si el parámetro child1 es null, el método introduce el contenido de child2 delante de todos loselementos secundarios del objeto XML (dicho de otro modo, detrás de ninguno). Si se proporciona child1 pero noexiste en el objeto XML, el objeto XML no se modifica y se devuelve undefined.

Si llama a este método en un elemento secundario XML que no es un elemento (texto, atributos, comentarios, pi, etc.),se devuelve undefined.


Parámetros

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.

Véase tambiénXML.insertChildBefore() Operador delete (XML) Objetos XML Construcción y transformación de objetos XML

Ejemplo

Este ejemplo añade un nuevo elemento al final de los elementos secundarios de un objeto XML:

La salida de trace() es la siguiente:

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

var xml:XML = <menu> <item>burger</item> <item>soda</item> </menu>;xml.insertChildAfter(xml.item[0], <saleItem>fries</saleItem>);trace(xml);

insertChildBefore() método AS3 function insertChildBefore(child1:Object, child2:Object):*


Introduce el parámetro child2 especificado antes del parámetro child1 en este objeto XML y devuelve el objetoresultante. Si el parámetro child1 es null, el método introduce el contenido de child2 delante de todos loselementos secundarios del objeto XML (dicho de otro modo, detrás de ninguno). Si se proporciona child1 pero noexiste en el objeto XML, el objeto XML no se modifica y se devuelve undefined.

Si llama a este método en un elemento secundario XML que no es un elemento (texto, atributos, comentarios, pi, etc.),se devuelve undefined.


Parámetros

child1:Object — El objeto del objeto de origen que se introduce detrás de child2.

child2:Object — El objeto que se va a introducir.

Valor devuelto* — El objeto XML resultante o undefined.

Véase tambiénXML.insertChildAfter() Operador delete (XML) Objetos XML Construcción y transformación de objetos XML

Ejemplo

Este ejemplo añade un nuevo elemento al final de los elementos secundarios de un objeto XML:


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

length() método AS3 function length():int


En el caso de objetos XML, este método siempre devuelve el entero 1. El método length() de la clase XMLListdevuelve el valor 1 para un objeto XMLList que contiene un solo valor.

Valor devueltoint — Siempre devuelve 1 para cualquier objeto XML.


localName() método

var xml:XML = <menu> <item>burger</item> <item>soda</item> </menu>;xml.insertChildBefore(xml.bar[0], <saleItem>fries</saleItem>);trace(xml);

AS3 function localName():Object


Proporciona la parte local del nombre completo del objeto XML.

Valor devueltoObject — El nombre local en forma de cadena (String) o null.


Ejemplo

El ejemplo siguiente demuestra cómo utilizar correctamente el método localName():

name() método AS3 function name():Object


Proporciona el nombre completo del objeto XML.

Valor devueltoObject — El nombre completo es un QName o null.

Véase tambiénXML.attributes() identificador de atributos Objetos XML

Ejemplo

El siguiente ejemplo ilustra el uso del método name() para obtener el nombre completo de un objeto XML:

El siguiente ejemplo ilustra el uso del método name() al que se llama en una propiedad XML, en un elemento detexto o en un atributo:

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



trace(xml.name().localName); // Envelopetrace(xml.name().uri); // "http://www.w3.org/2001/12/soap-envelope"

namespace() método AS3 function namespace(prefix:String = null):*


Si no se especifica ningún parámetro, proporciona el espacio de nombres asociado al nombre completo de este objetoXML. Si se especifica un parámetro prefix, el método devuelve el espacio de nombres que coincida con el parámetroprefix y esté en el ámbito del objeto XML. Si no existe el espacio de nombres en cuestión, el método devuelveundefined.

Parámetros

prefix:String (default = null) — El prefijo con el que desea averiguar si hay coincidencias.

Valor devuelto* — Devuelve null, undefined o un espacio de nombres.


Ejemplo

En el ejemplo siguiente, se utiliza el método namespace() para obtener el espacio de nombres de un objeto XMLy asignarlo a un objeto Namespace llamado soap que, después, se utiliza para identificar una propiedad delobjeto xml (xml.soap::Body[0]):

En el ejemplo siguiente, se utiliza el método namespace() para obtener el espacio de nombres predeterminadode un nodo, así como el espacio de nombres de un prefijo específico ("dc"):

var xml:XML = <foo x="15" y="22"> text </foo>;

trace(xml.name().localName); // footrace(xml.name().uri == ""); // truetrace(xml.children()[0]); // texttrace(xml.children()[0].name()); // nulltrace(xml.attributes()[0]); // 15trace(xml.attributes()[0].name()); // x



var soap:Namespace = xml.namespace();trace(soap.prefix); // soaptrace(soap.uri); // http://www.w3.org/2001/12/soap-envelope

var body:XML = xml.soap::Body[0];trace(body.namespace().prefix); // soaptrace(xml.namespace().uri); // http://www.w3.org/2001/12/soap-envelopetrace(body.namespace("wx").uri); // "http://example.com/weather"

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>;

namespaceDeclarations() método AS3 function namespaceDeclarations():Array


Enumera las declaraciones de espacio de nombres asociadas al objeto XML en el contexto de su elemento principal.

Valor devueltoArray — Una matriz de objetos Namespace.

Véase tambiénXML.namespace() Objetos XML

Ejemplo

El siguiente ejemplo da como resultado las declaraciones de espacios de nombres de un objeto XML:


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() método AS3 function nodeKind():String


Especifica el tipo de nodo: texto, comentario, instrucción de procesamiento, atributo o elemento.

Valor devueltoString — El tipo de nodo utilizado.

Véase tambiénidentificador de atributos Objetos XML

Ejemplo

Este ejemplo muestra los cinco tipos de nodos:

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

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);}

normalize() método AS3 function normalize():XML


Para el objeto XML y todos los objetos XML descendientes, funde los nodos de texto adyacentes y elimina los nodos detexto vacíos.

Valor devueltoXML — El objeto XML normalizado resultante.


Ejemplo

El ejemplo siguiente muestra el efecto que tiene llamar al método normalize():

parent() método AS3 function parent():*


Devuelve el elemento principal del objeto XML. Si el objeto XML carece de elemento principal, el método devuelveundefined.

Valor devuelto* — El objeto XML principal. Devuelve una cadena String o null.

Véase tambiénObjetos XML Navegación de estructuras XML

Ejemplo

En el ejemplo siguiente, se utiliza el método parent() para identificar el elemento principal de un elementoconcreto en una estructura XML:

XML.ignoreComments = false;XML.ignoreProcessingInstructions = false;

var xml:XML = <example id="10">  <?test this is a pi ?> and some text </example>;

trace(xml.nodeKind()); // elementtrace(xml.children()[0].nodeKind()); // commenttrace(xml.children()[1].nodeKind()); // processing-instructiontrace(xml.children()[2].nodeKind()); // texttrace(xml.@id[0].nodeKind()); // attribute

var xml:XML = <body></body>;xml.appendChild("hello");xml.appendChild(" world");trace(xml.children().length()); // 2xml.normalize();trace(xml.children().length()); // 1

var xml:XML = <body> Hello

prependChild() método AS3 function prependChild(value:Object):XML


Introduce una copia del objeto child (secundario) proporcionado en el elemento XML delante de cualquier propiedadXML existente para dicho elemento.


Parámetros

value:Object — El objeto que se va a introducir.


Véase tambiénOperador delete (XML) Objetos XML Construcción y transformación de objetos XML

Ejemplo

El siguiente ejemplo utiliza el método prependChild() para añadir un elemento al principio de una lista deelementos secundarios en un objeto XML:

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


Si se proporciona un parámetro name, enumera todos los elementos secundarios del objeto XML que contieneninstrucciones de procesamiento con dicho nombre name. Si no hay parámetros, el método enumera todos los elementossecundarios del objeto XML que contienen instrucciones de procesamiento.

Parámetros

name:String (default = "*") — El nombre de las instrucciones de procesamiento con las que va a establecerse lacorrespondencia.

Valor devueltoXMLList — Lista de objetos secundarios coincidentes.

Véase también

Test: <ul> <li>1</li> <li>2</li> </ul> </body>;var node:XML = xml.p.ul.(li.contains("1"))[0]; // == <ul>... </ul>trace(node.parent().@id); // p2

var xml:XML = <body> hello </body>;

xml.prependChild(world);trace(xml.p[0].toXMLString()); // worldtrace(xml.p[1].toXMLString()); // hello

Objetos XML

Ejemplo

El siguiente ejemplo utiliza el método processingInstructions() para obtener una matriz de instrucciones deprocesamiento para un objeto XML:

propertyIsEnumerable() método AS3 function propertyIsEnumerable(p:String):Boolean


Comprueba si la propiedad p está en el conjunto de propiedades que se pueden repetir en una sentencia for..inaplicada al objeto XML. Devuelve true sólo si toString(p) == "0".

Parámetros

p:String — La propiedad que desea comprobar.

Valor devueltoBoolean — Si la propiedad puede repetirse en una sentencia for..in, el valor es true; en caso contrario, esfalse.


Ejemplo

En el ejemplo siguiente, se muestra que para un objeto XML, el método propertyNameIsEnumerable() devuelveun valor true únicamente para el valor 0; mientras que en un objeto XMLList object, el valor devuelto es truepara cada valor de índice válido del objeto XMLList:

XML.ignoreProcessingInstructions = false;var xml:XML = <body> foo <?xml-stylesheet href="headlines.css" type="text/css" ?> <?instructionX ?>

</body>;

trace(xml.processingInstructions().length()); // 2trace(xml.processingInstructions()[0].name()); // xml-stylesheet

var xml:XML = <body> Hello World </body>;

trace(xml.propertyIsEnumerable(0)); // truetrace(xml.propertyIsEnumerable(1)); // false

for (var propertyName:String in xml) { trace(xml[propertyName]);}

var list:XMLList = xml.p;trace(list.propertyIsEnumerable(0)); // truetrace(list.propertyIsEnumerable(1)); // truetrace(list.propertyIsEnumerable(2)); // false

for (var propertyName:String in list) { trace(list[propertyName]);}

removeNamespace() método AS3 function removeNamespace(ns:Namespace):XML


Elimina el espacio de nombres proporcionado para este objeto y todos los descendientes. El métodoremoveNamespaces() no elimina un espacio de nombres si el nombre completo del objeto o el nombre completo de losatributos del objeto hacen referencia a él.

Parámetros

ns:Namespace — El espacio de nombres que se va a eliminar.

Valor devueltoXML — Una copia del objeto XML resultante.


Ejemplo

El siguiente ejemplo muestra cómo eliminar una declaración de espacio de nombres en un objeto XML:

replace() método AS3 function replace(propertyName:Object, value:XML):XML


Sustituye las propiedades especificadas mediante el parámetro propertyName por el parámetro value. Si no hayninguna propiedad que coincida con propertyName, el objeto XML permanecerá sin cambios.

Parámetros

propertyName:Object — Puede tratarse de un valor numérico, un nombre incompleto para un conjunto deelementos XML, un nombre completo para un conjunto de elementos XML o el comodín de asterisco ("*"). Utilice unnombre incompleto para identificar elementos XML en el espacio de nombres predeterminado.

value:XML — El valor de sustitución. Puede ser un objeto XML, un objeto XMLList o cualquier valor que puedaconvertirse con toString().

Valor devueltoXML — El objeto XML resultante, con las propiedades coincidentes sustituidas.


Ejemplo

El siguiente ejemplo ilustra la llamada al método replace() con un entero como primer parámetro:

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); // 3trace(xml.namespaceDeclarations()[0] is String); //var dc:Namespace = xml.namespace("dc");xml.removeNamespace(dc);trace(xml.namespaceDeclarations().length); // 2

var xml:XML = <body>

Este código da como resultado la salida trace() siguiente:

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

El siguiente ejemplo llama al método replace() con una cadena como primer parámetro:


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

El siguiente ejemplo ilustra la llamada al método replace() con un objeto QName como primer parámetro:


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

El siguiente ejemplo ilustra la llamada al método replace() con la cadena "*" como primer parámetro:

Hello World <hr/> </body>;

xml.replace(1, Bob);trace(xml);

var xml:XML = <body> Hello World <hr/> </body>;

xml.replace("p", Hi);trace(xml);

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, Bob);trace(xml);

var xml:XML = <body> Hello World <hr/> </body>;

xml.replace("*", <img src = "hello.jpg"/>);trace(xml);

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

setChildren() método AS3 function setChildren(value:Object):XML


Sustituye las propiedades secundarias del objeto XML por el conjunto especificado de propiedades XML, proporcionadasen el parámetro value.

Parámetros

value:Object — Las propiedades XML sustitutas. Puede ser un único objeto XML o un objeto XMLList.



Ejemplo

El siguiente ejemplo ilustra la llamada al método setChildren() utilizando primero un objeto XML comoparámetro y, después, utilizando como parámetro un objeto XMLList:

setLocalName() método AS3 function setLocalName(name:String):void


Cambia el nombre local del objeto XML al parámetro name especificado.

Parámetros

name:String — El nombre sustituto para el nombre local.

var xml:XML = <body> Hello World </body>;

var list:XMLList = xml.p;

xml.setChildren(hello);trace(xml);

// <body>// hello// </body>

xml.setChildren(list);trace(xml);

// <body>// Hello// World// </body>

Ejemplo

El siguiente ejemplo utiliza el método setLocalName() para cambiar el nombre local de un elemento XML:

setName() método AS3 function setName(name:String):void


Establece el nombre del objeto XML con el nombre completo o nombre de atributo especificado.

Parámetros

name:String — El nuevo nombre del objeto.


Ejemplo

El siguiente ejemplo utiliza el método setName() para cambiar el nombre de un elemento XML:

setNamespace() método AS3 function setNamespace(ns:Namespace):void


Establece el espacio de nombres asociado al objeto XML.

Parámetros

ns:Namespace — El nuevo espacio de nombres.


Ejemplo

En el ejemplo siguiente, se utiliza el espacio de nombres soap definido en un objeto XML y se aplica al espacio denombres de otro objeto XML (xml2):

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>

var xml:XML = <item> toothbrush </item>;

xml.setName("orderItem");trace(xml.toXMLString()); // <orderItem>toothbrush</orderItem>

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">

setSettings() método AS3 static function setSettings(... rest):void


Establece valores para las siguientes propiedades XML: ignoreComments, ignoreProcessingInstructions,ignoreWhitespace, prettyIndent y prettyPrinting. A continuación se indica la configuración predeterminada, quese aplica si no se proporciona ningún parámetro setObj:

XML.ignoreComments = trueXML.ignoreProcessingInstructions = trueXML.ignoreWhitespace = trueXML.prettyIndent = 2XML.prettyPrinting = true

Nota: este método no se aplica a una instancia de la clase XML, sino que se aplica a XML, como en el siguiente código:XML.setSettings().

Parámetros

... rest — Un objeto con las propiedades siguientes:

ignoreCommentsignoreProcessingInstructionsignoreWhitespaceprettyIndentprettyPrinting

Véase tambiénignoreComments ignoreProcessingInstructions ignoreWhitespace prettyIndent prettyPrinting defaultSettings() settings() Parámetros de función Objetos XML

Ejemplo


 </soap:Envelope>;var ns:Namespace = xml1.namespace("soap");

var xml2:XML = <Envelope> <Body/> </Envelope>;

xml2.setNamespace(ns);

trace(xml2);


var xml1:XML = <foo>  <?instruction ?>

settings() método AS3 static function settings():Object


Recupera las siguientes propiedades: ignoreComments, ignoreProcessingInstructions, ignoreWhitespace,prettyIndent y prettyPrinting.

Valor devueltoObject — Un objeto con las propiedades XML siguientes:

ignoreCommentsignoreProcessingInstructionsignoreWhitespaceprettyIndentprettyPrinting

Véase tambiénXML.ignoreComments XML.ignoreProcessingInstructions XML.ignoreWhitespace XML.prettyIndent XML.prettyPrinting XML.defaultSettings() XML.setSettings()

Ejemplo


</foo>;trace(xml1.toXMLString());// <foo>// // <?instruction ?>// </foo>

XML.setSettings(XML.defaultSettings());var xml2:XML = <foo>  <?instruction ?> </foo>;trace(xml2.toXMLString());


var xml1:XML = <foo>  <?instruction ?> </foo>;trace(xml1.toXMLString());// <foo>// // <?instruction ?>// </foo>

XML.setSettings(XML.defaultSettings());var xml2:XML = <foo>

text() método AS3 function text():XMLList


Devuelve un objeto XMLList con todas las propiedades XML del objeto XML que representan los nodos de texto XML.

Valor devueltoXMLList — La lista de propiedades.


Ejemplo

El siguiente ejemplo utiliza el método text() para obtener los nodos de texto de un objeto XML:

toString() método AS3 function toString():String


Devuelve una representación de cadena del objeto XML. Las reglas para esta conversión dependen de si el objeto XMLtiene contenido simple o contenido complejo:

Si el objeto XML tiene contenido simple, toString() devuelve el contenido de cadena del objeto XML con lasiguiente información eliminada: la etiqueta inicial, los atributos, las declaraciones de espacio de nombres y laetiqueta final.

Si el objeto XML tiene contenido complejo, toString() devuelve una cadena (String) con codificación XML querepresenta al objeto XML completo, incluidos la etiqueta inicial, los atributos, las declaraciones de espacio denombres y la etiqueta final.

Para que se devuelva siempre el objeto XML completo, utilice toXMLString().

Valor devueltoString — La representación de cadena del objeto XML.

Véase tambiénXML.hasSimpleContent() XML.hasComplexContent() XML.toXMLString() Conversión de tipo XML

Ejemplo

El siguiente ejemplo muestra qué devuelve el método toString() cuando el objeto XML tiene contenido simple:

<?instruction ?> </foo>;trace(xml2.toXMLString());

var xml:XML = <body> text1 <hr/> text2 </body>;trace(xml.text()[0]); // text1trace(xml.text()[1]); // text2

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

El siguiente ejemplo muestra qué devuelve el método toString() cuando el objeto XML tiene contenidocomplejo:

toXMLString() método AS3 function toXMLString():String


Devuelve una representación de cadena del objeto XML. A diferencia del método toString(), el métodotoXMLString() siempre devuelve la etiqueta inicial, los atributos y la etiqueta final del objeto XML, con independenciade si el objeto XML tiene contenido simple o complejo. (El método toString() elimina estos elementos en el caso deobjetos XML que tienen contenido simple.)

Valor devueltoString — La representación de cadena del objeto XML.

Véase tambiénXML.toString() Objetos XML Conversión de tipo XML

Ejemplo

El siguiente ejemplo muestra la diferencia entre utilizar el método toString() (que se aplica a todos losparámetros de un método trace() de forma predeterminada) y utilizar el método toXMLString():

valueOf() método AS3 function valueOf():XML


Devuelve el objeto XML.

Valor devueltoXML — El valor simple de una instancia XML.


Ejemplo

El siguiente ejemplo muestra que el valor devuelto por el método valueOf() es el mismo que el objeto XML deorigen:

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

var xml:XML = hello;trace(xml); // hellotrace(xml.toXMLString()); // hello

var xml:XML = hello;trace(xml.valueOf() === xml); // true

Ejemplos Cómo utilizar los ejemplos

XMLExample.as

El siguiente ejemplo primero crea una variable XML y luego le añade nodos. Las propiedades XML se utilizan parabuscar e imprimir nodos XML. Observe que el símbolo "arroba" (@) se utiliza en varias de las llamadas a trace() paralocalizar la información 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); // 98765

trace(employees.employee[1].@ssn); // 789-789-7890

trace(employees.employee.name); // <name first="John" last="Doe"/> // <name first="Mary" last="Roe"/>

trace(employees..zip[0]); // 98765

trace(employees..@ssn[1]); // 789-789-7890

trace(employees..name); // <name first="John" last="Doe"/> // <name first="Mary" last="Roe"/>

trace(employees.employee[0].address.*); // <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/ExampleInstruct.html

// <address> // <street>99 Broad St.</street> // <city>Newton</city> // <state>MA</state> // <zip>01234</zip> // </address> // </employee> } }}

xml - referencia del lenguaje y componentes actionscript 3.0

Documents