Метод Sys.Net.WebRequest add_completed

Регистрирует обработчик завершенных событий веб-запроса.

MyWebRequest.add_completed(handler);

Термин

Определение

handler

Функция, зарегистрированная для обработки завершенных событий запроса.

Исполнитель, связанный с веб-запросом, инициирует завершенное событие запроса, вызвав метод completed. Функция обработчика вызывается для обработки возвращаемых данных, если работа, выполняемая соответствующей управляющей программой, закончена. Обратите внимание, что завершение не означает успех. Исполнитель заканчивает свою работу в одном из трех состояний: "Завершена", "Прервана" или "Время ожидания истекло".

Зарегистрированная функция обработчика событий должна принимать два параметра.

  • Ссылка на выполнитель, который отправил сетевой запрос. Можно обратиться к выполнителю, чтобы проверить его состояние и извлечь данные ответа.

  • Параметр eventArgs, установленный выполнителем, вызвавшем завершенное событие запроса. Для выполнителей, используемых по умолчанию, этот аргумент имеет значение Свойство Sys.EventArgs.empty.

Обработчик событий может определить состояние выполнителя, используя одно из следующих свойств выполнителя: responseAvailable, aborted или timedOut.

Обработчик событий имеет доступ к другим данным ответа об выполнителе, только если responseAvailable возвращает true.

В приведенном далее примере кода демонстрируется добавление и удаление обработчика завершенных событий. Данный пример кода является частью полного примера, приведенного в общих сведениях о классе 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();  
}


Показ: