| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
La clase XMLList contiene métodos para trabajar con uno o varios elementos XML. Un objeto XMLList puede representar uno o varios objetos o elementos XML (incluidos varios nodos o atributos), por lo que puede llamar a métodos de los elementos como a un grupo o a los distintos elementos de la colección.
Si un objeto XMLList tiene sólo un elemento XML, puede utilizar los métodos de la clase XML directamente en el objeto XMLList. En el siguiente ejemplo, example.two es un objeto XMLList de longitud 1, de manera que puede llamar en él a cualquier método XML.
var example2 = <example><two>2</two></example>;
Si intenta utilizar métodos de la clase XML con un objeto XMLList que contenga más de un objeto XML, se emitirá una excepción; lo que debe hacer iterar en la colección XMLList (con una sentencia for each..in, por ejemplo) y aplicar los métodos a cada objeto XML de la colección.
Ver los ejemplos
public function XMLList(value:Object)
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Crea un nuevo objeto XMLList.
Parámetros
| value:Object — Cualquier objeto que pueda convertirse en un objeto XMLList utilizando la función XMLList() de nivel superior.
|
Véase también
AS3 function attribute(attributeName:*):XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Llama al método attribute() de cada objeto XML y devuelve un objeto XMLList de los resultados. Los resultados coinciden con el parámetro attributeName especificado. Si no hay ninguna coincidencia, el método attribute() devuelve un objeto XMLList vacío.
Parámetros
| attributeName:* — Nombre del atributo que desea incluir en un objeto XMLList.
|
Valor devuelto
| XMLList — Un objeto XMLList de objetos XML coincidentes o un objeto XMLList vacío.
|
Véase también
AS3 function attributes():XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Llama al método attributes() de cada objeto XML y devuelve un objeto XMLList de atributos por cada objeto XML.
Valor devuelto
| XMLList — Un objeto XMLList de atributos por cada objeto XML.
|
Véase también
AS3 function child(propertyName:Object):XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Llama al método child() de cada objeto XML y devuelve un objeto XMLList que contiene los resultados por orden.
Parámetros
| 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 parámetro de entrada.
|
Véase también
AS3 function children():XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Llama al método children() de cada objeto XML y devuelve un objeto XMLList que contiene los resultados.
Valor devuelto
| XMLList — Un objeto XMLList de los elementos secundarios de los objetos XML.
|
Véase también
AS3 function comments():XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Llama al método comments() de cada objeto XML y devuelve un objeto XMLList de comentarios.
Valor devuelto
| XMLList — Un objeto XMLList de los comentarios de los objetos XML.
|
Véase también
AS3 function contains(value:XML):Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Comprueba si el objeto XMLList contiene un objeto XML que es igual al parámetro value especificado.
Parámetros
| value:XML — Un objeto XML con el que comparar el objeto XMLList actual.
|
Valor devuelto
| Boolean — Si XMLList contiene el objeto XML declarado en el parámetro value, el valor es true; en caso contrario, el valor es false.
|
Véase también
AS3 function copy():XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Devuelve una copia del objeto XMLList en cuestión. 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 método parent().
Valor devuelto
| XMLList — La copia del objeto XMLList.
|
Véase también
AS3 function descendants(name:Object = *):XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Devuelve todos los descendientes (elementos secundarios, terciarios, cuaternarios, etc.) del objeto XML que tiene el parámetro name. El parámetro 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 parámetro asterisco (*). Si no se pasa ningún parámetro, se pasa la cadena "*" y se 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 devuelto
| XMLList — Un objeto XMLList de los descendientes coincidentes (elementos secundarios, terciarios, etc.) de los objetos XML de la lista original. Si no hay descendientes, devuelve un objeto XMLList vacío.
|
Véase también
AS3 function elements(name:Object = *):XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Llama al método elements() de cada objeto XML. El parámetro name se pasa al método descendants(). Si no se pasa ningún parámetro, se pasa la cadena "*" al método descendants().
Parámetros
| name:Object (default = *) — El nombre de los elementos con los que va a establecerse la correspondencia.
|
Valor devuelto
| XMLList — Un objeto XMLList de los elementos secundarios coincidentes de los objetos XML.
|
Véase también
AS3 function hasComplexContent():Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Comprueba si el objeto XMLList tiene un contenido complejo. Se considera que un objeto XMLList tiene contenido complejo si no está vacío y se cumple una de estas condiciones:
- El objeto XMLList contiene un único elemento XML con contenido complejo.
- El objeto XMLList contiene elementos.
Valor devuelto
| Boolean — Si el objeto XMLList tiene un contenido complejo, el valor es true; en caso contrario, el valor es false.
|
Véase también
AS3 function hasOwnProperty(p:String):Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Comprueba la propiedad especificada por p.
Parámetros
| p:String — La propiedad con la que se va a establecer la correspondencia.
|
Valor devuelto
| Boolean — Si el parámetro existe, el valor es true; en caso contrario, el valor es false.
|
Véase también
AS3 function hasSimpleContent():Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Comprueba si el objeto XMLList tiene un contenido simple. Se considera que un objeto XMLList tiene contenido simple si se cumplen una o varias de estas condiciones:
- El objeto XMLList está vacío
- El objeto XMLList contiene un único elemento XML con contenido simple
- El objeto XMLList no contiene elementos
Valor devuelto
| Boolean — Si el objeto XMLList tiene un contenido simple, el valor es true; en caso contrario, el valor es false.
|
Véase también
AS3 function length():int
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Devuelve el número de propiedades del objeto XMLList.
Valor devuelto
| int — El número de propiedades del objeto XMLList.
|
Véase también
AS3 function normalize():XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Funde nodos de texto adyacentes y elimina los nodos de texto vacíos en los siguientes casos: todos los nodos de texto de XMLList, todos los objetos XML contenidos en XMLList y los descendientes de todos los objetos XML de XMLList.
Valor devuelto
| XMLList — El objeto XMLList normalizado.
|
Véase también
AS3 function parent():Object
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Devuelve el elemento principal del objeto XMLList si todos los elementos del objeto XMLList tienen el mismo elemento principal. Si el objeto XMLList carece de elemento principal o tiene varios elementos principales, el método devuelve undefined.
Valor devuelto
| Object — Devuelve el objeto XML principal.
|
Véase también
AS3 function processingInstructions(name:String = "*"):XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Si se proporciona un parámetro name, enumera todos los elementos secundarios del objeto XMLList que contienen instrucciones de procesamiento con dicho nombre. Si no hay parámetros, el método enumera todos los elementos secundarios del objeto XMLList que contienen instrucciones de procesamiento.
Parámetros
| name:String (default = "*") — El nombre de las instrucciones de procesamiento con las que va a establecerse la correspondencia.
|
Valor devuelto
| XMLList — Un objeto XMLList que contiene las instrucciones de procesamiento para cada objeto XML.
|
Véase también
AS3 function propertyIsEnumerable(p:String):Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión 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 XMLList. El valor es true sólo si toNumber(p) es mayor o igual que 0 y menor que la longitud del objeto XMLList.
Parámetros
| p:String — El índice de una propiedad que se va a comprobar.
|
Valor devuelto
| Boolean — Si la propiedad puede repetirse en una sentencia for..in, el valor es true; en caso contrario, es false.
|
Véase también
AS3 function text():XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Llama al método text() de cada objeto XML y devuelve un objeto XMLList que contiene los resultados.
Valor devuelto
| XMLList — Un objeto XMLList de todas las propiedades XML del objeto XMLList que representa los nodos de texto XML.
|
Véase también
AS3 function toString():String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Devuelve una representación de cadena de todos los objetos XML de un objeto XMLList. Las reglas para esta conversión 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 información 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 con codificación 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 el método toXMLString().
Valor devuelto
| String — La representación de cadena del objeto XML.
|
Véase también
Ejemplo
El siguiente ejemplo muestra qué devuelve el método
toString() cuando el objeto XML tiene contenido simple:
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 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>
AS3 function toXMLString():String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Devuelve una representación de cadena de todos los objetos XML de un objeto XMLList. A diferencia del método toString(), el método 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 método toString() elimina estos elementos en el caso de objetos XML que tienen contenido simple.)
Valor devuelto
| String — La representación de cadena del objeto XML.
|
Véase también
AS3 function valueOf():XMLList
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Devuelve el objeto XMLList.
Valor devuelto
| XMLList — Devuelve el objeto XMLList actual.
|
Véase también
En el ejemplo siguiente, se crea una propiedad XML llamada
books y se añaden varios elementos con las etiquetas
book publisher y
name a un nodo llamado
books. Seguidamente, se llama al método
showBooksByPublisher(), que toma el objeto XMLList y devuelve cada elemento que coincida con el editor, "Addison-Wesley".
package {
import flash.display.Sprite;
public class XMLListExample extends Sprite {
private var books:XML;
public function XMLListExample() {
books = <books>
<book publisher="Addison-Wesley" name="Design Patterns" />
<book publisher="Addison-Wesley" name="The Pragmatic Programmer" />
<book publisher="Addison-Wesley" name="Test Driven Development" />
<book publisher="Addison-Wesley" name="Refactoring to Patterns" />
<book publisher="O'Reilly Media" name="The Cathedral & the Bazaar" />
<book publisher="O'Reilly Media" name="Unit Test Frameworks" />
</books>;
showBooksByPublisher("Addison-Wesley");
}
private function showBooksByPublisher(name:String):void {
var results:XMLList = books.book.(@publisher == name);
showList(results);
}
private function showList(list:XMLList):void {
var item:XML;
for each(item in list) {
trace("item: " + item.toXMLString());
}
}
}
}
© 2004-2007 Adobe Systems Incorporated. Todos los derechos reservados.
Fri Oct 12 2007, 2:30 AM GMT-07:00
Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XMLList.html