Sys.Net.WebRequest add_completed (Método)
Actualización: noviembre 2007
Registra un controlador para el evento de solicitud completada de la solicitud web.
MyWebRequest.add_completed(handler);
Arguments
Término |
Definition |
|---|---|
handler |
Función registrada para controlar el evento de solicitud completada. |
Comentarios
El elemento de ejecución asociado a la solicitud web provoca el evento de solicitud completada llamando al método completed. Se llama a la función del controlador para procesar los datos devueltos cuando finaliza la tarea del elemento de ejecución asociado. Tenga en cuenta que la finalización no implica que se haya realizado correctamente. Un elemento de ejecución finaliza su trabajo en uno de tres estados: completado, anulado o tiempo de espera agotado.
La función de controlador de eventos registrada debe aceptar dos parámetros:
Una referencia al elemento de ejecución que emitió la solicitud de red. Puede tener acceso al elemento de ejecución para comprobar su estado y recuperar los datos de respuesta.
Un parámetro eventArgs establecido por el elemento de ejecución que provocó el evento de solicitud completada. Para los elementos de ejecución predeterminados, este argumento está establecido en Sys.EventArgs.empty (Propiedad).
El controlador de eventos puede determinar el estado del elemento de ejecución utilizando una de las siguientes propiedades del elemento de ejecución: responseAvailable, abortedo timedOut.
El controlador de eventos sólo puede tener acceso a otra información de respuesta del elemento de ejecución si responseAvailable devuelve true.
Ejemplo
En el ejemplo siguiente se muestra cómo agregar y quitar el controlador de eventos completados. Este código forma parte de un ejemplo completo que se encuentra en la información general de la clase WebRequest.
// This function adds and removes the
// Web request completed event handler.
function WebRequestCompleted()
{
// Instantiate the WebRequest.
var wRequest = new Sys.Net.WebRequest();
// Set the request Url.
wRequest.set_url(getPage);
// Set the web request completed event handler,
// for processing return data.
wRequest.add_completed(OnWebRequestCompleted);
alert("Added Web request completed handler");
// Remove the web request completed event handler.
// Comment the following two lines if you want to
// use the handler.
wRequest.remove_completed(OnWebRequestCompleted);
alert("Removed handler; the Web request return is not processed.");
// Execute the request.
wRequest.invoke();
}
Vea también
Referencia
Sys.Net.WebRequestManager (Clase)