XMLList

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

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Elementos de API relacionados

XML
for each..in
Namespace
QName

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		XMLList(value:Object) Crea un nuevo objeto XMLList.	XMLList
		attribute(attributeName:*):XMLList Llama al método attribute() de cada objeto XML y devuelve un objeto XMLList de los resultados.	XMLList
		attributes():XMLList Llama al método attributes() de cada objeto XML y devuelve un objeto XMLList de atributos por cada objeto XML.	XMLList
		child(propertyName:Object):XMLList Llama al método child() de cada objeto XML y devuelve un objeto XMLList que contiene los resultados por orden.	XMLList
		children():XMLList Llama al método children() de cada objeto XML y devuelve un objeto XMLList que contiene los resultados.	XMLList
		comments():XMLList Llama al método comments() de cada objeto XML y devuelve un objeto XMLList de comentarios.	XMLList
		contains(value:XML):Boolean Comprueba si el objeto XMLList contiene un objeto XML que es igual al parámetro value especificado.	XMLList
		copy():XMLList Devuelve una copia del objeto XMLList en cuestión.	XMLList
		descendants(name:Object = *):XMLList Devuelve todos los descendientes (elementos secundarios, terciarios, cuaternarios, etc.) del objeto XML que tiene el parámetro name.	XMLList
		elements(name:Object = *):XMLList Llama al método elements() de cada objeto XML.	XMLList
		hasComplexContent():Boolean Comprueba si el objeto XMLList tiene un contenido complejo.	XMLList
		hasOwnProperty(p:String):Boolean Comprueba la propiedad especificada por p.	XMLList
		hasSimpleContent():Boolean Comprueba si el objeto XMLList tiene un contenido simple.	XMLList
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		length():int Devuelve el número de propiedades del objeto XMLList.	XMLList
		normalize():XMLList 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.	XMLList
		parent():Object Devuelve el elemento principal del objeto XMLList si todos los elementos del objeto XMLList tienen el mismo elemento principal.	XMLList
		processingInstructions(name:String = "*"):XMLList Si se proporciona un parámetro name, enumera todos los elementos secundarios del objeto XMLList que contienen instrucciones de procesamiento con dicho nombre.	XMLList
		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 XMLList.	XMLList
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		text():XMLList Llama al método text() de cada objeto XML y devuelve un objeto XMLList que contiene los resultados.	XMLList
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve una representación de cadena de todos los objetos XML de un objeto XMLList.	XMLList
		toXMLString():String Devuelve una representación de cadena de todos los objetos XML de un objeto XMLList.	XMLList
		valueOf():XMLList Devuelve el objeto XMLList.	XMLList

Información sobre constructores

()

Información sobre

public function XMLList(value:Object)

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

Función XMLList() de nivel superior

Información sobre métodos

attribute

()

método

AS3 function attribute(attributeName:*):XMLList

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

XML.attribute()
XML.attributes()

attributes

()

método

AS3 function attributes():XMLList

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

XML.attribute()
XML.attributes()

child

()

método

AS3 function child(propertyName:Object):XMLList

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

XML.child()

children

()

método

AS3 function children():XMLList

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

XML.children()

comments

()

método

AS3 function comments():XMLList

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

XML.comments()

contains

()

método

AS3 function contains(value:XML):Boolean

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

copy

()

método

AS3 function copy():XMLList

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

descendants

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

XML.descendants()

elements

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

XML.elements()

hasComplexContent

()

método

AS3 function hasComplexContent():Boolean

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

hasSimpleContent()
XML.hasComplexContent()
XML.hasSimpleContent()

hasOwnProperty

()

método

AS3 function hasOwnProperty(p:String):Boolean

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

hasSimpleContent

()

método

AS3 function hasSimpleContent():Boolean

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

hasComplexContent()
XML.hasComplexContent()
XML.hasSimpleContent()

length

()

método

AS3 function length():int

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9

Devuelve el número de propiedades del objeto XMLList.

Valor devuelto

int — El número de propiedades del objeto XMLList.

normalize

()

método

AS3 function normalize():XMLList

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

parent

()

método

AS3 function parent():Object

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

processingInstructions

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

XML.processingInstructions()

propertyIsEnumerable

()

método

AS3 function propertyIsEnumerable(p:String):Boolean

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

text

()

método

AS3 function text():XMLList

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

XML.text()

toString

()

método

AS3 function toString():String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

hasComplexContent()
hasSimpleContent()
toXMLString()

Ejemplo ( Cómo utilizar este 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>

toXMLString

()

método

AS3 function toXMLString():String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, 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.

Elementos de API relacionados

toString()

valueOf

()

método

AS3 function valueOf():XMLList

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9

Devuelve el objeto XMLList.

Valor devuelto

XMLList — Devuelve el objeto XMLList actual.

Ejemplos Cómo utilizar este ejemplo

XMLListExample.as

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

Avisos legales | Política de privacidad en línea

XMLList - AS3

Clases x

XMLList

attribute

attributes

child

children

comments

contains

copy

descendants

elements

hasComplexContent

hasOwnProperty

hasSimpleContent

length

normalize

parent

processingInstructions

propertyIsEnumerable

text

toString

toXMLString

valueOf