Clase XML

Disponibilidad

Flash Player 5 (pasó a ser un objeto nativo en Flash Player 6, lo cual mejoró el rendimiento notablemente).

Descripción

Utilice los métodos y las propiedades del objeto XML para cargar, analizar, enviar, construir y manipular árboles de documentos XML.

Debe utilizar el constructor new XML() para crear un objeto XML antes de llamar a los métodos de la clase XML.

Resumen de métodos para la clase XML

Método	Descripción
`XML.addRequestHeader()`	Añade o cambia los encabezados HTTP para las operaciones `POST`.
`XML.appendChild()`	Anexa un nodo al final de la lista de objetos secundarios del objeto especificado.
`XML.cloneNode()`	Duplica el nodo especificado y, opcionalmente, puede duplicar repetidamente todos los nodos secundarios.
`XML.createElement()`	Crea un nuevo elemento XML.
`XML.createTextNode()`	Crea un nuevo nodo de texto XML.
`XML.getBytesLoaded()`	Devuelve el número de bytes cargados para el documento XML especificado.
`XML.getBytesTotal()`	Devuelve el tamaño del documento XML, expresado en bytes.
`XML.hasChildNodes()`	Devuelve `true` si el nodo especificado tiene nodos secundarios; de lo contrario, devuelve `false`.
`XML.insertBefore()`	Inserta un nodo delante de un nodo existente en la lista de nodos secundarios del nodo especificado.
`XML.load()`	Carga un documento (especificado por el objeto XML) desde una URL.
`XML.parseXML()`	Analiza un documento XML en el árbol de objeto XML especificado.
`XML.removeNode()`	Elimina el nodo especificado de su nodo principal.
`XML.send()`	Envía el objeto XML especificado a una URL.
`XML.sendAndLoad()`	Envía el objeto XML especificado a una URL y carga la respuesta del servidor en otro objeto XML.
`XML.toString()`	Convierte el nodo especificado y cualquiera de sus secundarios en texto XML.

Resumen de propiedades para la clase XML

Propiedad	Descripción
`XML.contentType`	Indica el tipo MIME transmitido al servidor.
`XML.docTypeDecl`	Establece y devuelve información sobre la declaración `DOCTYPE` de un documento XML.
`XML.firstChild`	Sólo lectura; hace referencia al primer nodo secundario de la lista del nodo especificado.
`XML.ignoreWhite`	Cuando se establecen en `true`, los nodos de texto que sólo contienen espacios en blanco se descartan durante el proceso de análisis.
`XML.lastChild`	Hace referencia al último nodo secundario de la lista del nodo especificado.
`XML.loaded`	Sólo lectura; comprueba si se ha cargado el objeto XML especificado.
`XML.nextSibling`	Sólo lectura, hace referencia al siguiente nodo colateral en la lista de nodos secundarios del nodo principal.
`XML.nodeName`	El nombre de nodo de un objeto XML.
`XML.nodeType`	Tipo del nodo especificado (nodo de texto o elemento XML).
`XML.nodeValue`	Texto del nodo especificado si el nodo es un nodo de texto.
`XML.parentNode`	Sólo lectura; hace referencia al nodo principal del nodo especificado.
`XML.previousSibling`	Sólo lectura; hace referencia al nodo colateral anterior en la lista de nodos secundarios del nodo principal.
`XML.status`	Código de estado numérico que indica el éxito o el fracaso de una operación de análisis de un documento XML.
`XML.xmlDecl`	Especifica información sobre una declaración XML de documento.

Resumen de colecciones para la clase XML

Método	Descripción
`XML.attributes`	Devuelve una matriz asociativa que contiene todos los atributos del nodo especificado.
`XML.childNodes`	Sólo lectura; devuelve una matriz que contiene referencias a los nodos secundarios del nodo especificado.

Resumen de controladores de eventos para la clase XML

Controlador de eventos	Descripción
`XML.onData`	Un controlador de eventos que se invoca cuando el texto XML se ha descargado completamente del servidor o cuando se produce un error al descargar texto XML de un servidor.
`XML.onLoad()`	Un controlador de eventos que devuelve un valor booleano que indica si se ha cargado correctamente el objeto XML con `XML.load()` o `XML.sendAndLoad()`.

Constructor para la clase XML

Disponibilidad

Flash Player 5.

Sintaxis

new XML([source])

Parámetros

source Texto XML que se va a analizar para crear un nuevo objeto XML.

Valor devuelto

Ninguno.

Descripción

Constructor; crea un nuevo objeto XML. Debe utilizar el constructor para crear un objeto XML antes de llamar a los métodos de la clase XML.

Nota: los métodos createElement() y createTextNode() son los métodos "constructores" para crear los elementos y los nodos de texto en un árbol de documentos XML.

Ejemplo

Sintaxis 1: en el ejemplo siguiente se crea un nuevo objeto XML vacío.

my_xml = new XML();

Sintaxis 2: en el ejemplo siguiente se crea un objeto XML analizando el texto XML especificado en el parámetro source y se rellena el objeto XML recién creado con el árbol del documento XML resultante.

anyOtherXML = new XML("<state>California<city>San Francisco</city></state>");

Véase también

XML.createElement(), XML.createTextNode()