PaqueteNivel superior
Clasepublic final dynamic class XMLList
HerenciaXMLList Inheritance Object

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

Véase también

XML
for each..in
Namespace
QName


Propiedades públicas
 PropiedadDefinido por
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
Métodos públicos
 MétodoDefinido 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
  
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
  
Llama al método children() de cada objeto XML y devuelve un objeto XMLList que contiene los resultados.
XMLList
  
Llama al método comments() de cada objeto XML y devuelve un objeto XMLList de comentarios.
XMLList
  
Comprueba si el objeto XMLList contiene un objeto XML que es igual al parámetro value especificado.
XMLList
  
Devuelve una copia del objeto XMLList en cuestión.
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
  
Comprueba si el objeto XMLList tiene un contenido complejo.
XMLList
  
Comprueba la propiedad especificada por p.
XMLList
  
Comprueba si el objeto XMLList tiene un contenido simple.
XMLList
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
  
Devuelve el número de propiedades del objeto XMLList.
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
  
Devuelve el elemento principal del objeto XMLList si todos los elementos del objeto XMLList tienen el mismo elemento principal.
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
  
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
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
  
Llama al método text() de cada objeto XML y devuelve un objeto XMLList que contiene los resultados.
XMLList
  
Devuelve una representación de cadena de todos los objetos XML de un objeto XMLList.
XMLList
  
Devuelve una representación de cadena de todos los objetos XML de un objeto XMLList.
XMLList
  
Devuelve el objeto XMLList.
XMLList
Información sobre constructores
XMLList()constructor
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

Información sobre métodos
attribute()método
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

attributes()método 
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

child()método 
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

children()método 
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

comments()método 
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

contains()método 
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

copy()método 
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

descendants()método 
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

elements()método 
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

hasComplexContent()método 
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:

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

hasOwnProperty()método 
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

hasSimpleContent()método 
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:

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

length()método 
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

normalize()método 
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

parent()método 
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

processingInstructions()método 
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

propertyIsEnumerable()método 
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

text()método 
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

toString()método 
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:

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>
toXMLString()método 
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

valueOf()método 
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

Ejemplos Cómo utilizar los ejemplos
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());
            }
        }
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/XMLList.html