XML.onData

Disponibilidad

Flash Player 5

Sintaxis

my_xml.onData = function(src) {
  // las sentencias se escriben aquí
}

Parámetros

src Datos sin procesar, normalmente en formato XML, enviados por el servidor.

Valor devuelto

Ninguno.

Descripción

Controlador de eventos; 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. Este controlador se invoca antes de que se analice el texto XML y, por lo tanto, puede utilizarse para llamar a una rutina de análisis personalizada en lugar de utilizar el analizador XML de Flash. El método XML.onData devuelve el valor undefined o bien una cadena que contiene texto XML descargado del servidor. Si el valor devuelto es undefined, significa que se ha producido un error al descargar el texto XML del servidor.

De forma predeterminada, el método XML.onData invoca XML.onLoad(). Puede sustituir el método XML.onData por el comportamiento que desee, pero ya no se llamará al método XML.onLoad() a menos que lo haga en su implementación de XML.onData.

Ejemplo

En el ejemplo siguiente se muestra el aspecto que tiene el método onData de forma predeterminada:

XML.prototype.onData = function (src) {
  if (src == undefined) {
    this.onLoad(false);
  } else {
    this.parseXML(src);
    this.loaded = true;
    this.onLoad(true);
  }
}

El método XML.onData puede sustituirse para interceptar el texto XML sin analizarlo.