Свойство Sys.Net.WebRequest executor

  • Статья

Возвращает или задает выполнителя веб-запросов для экземпляра Sys.Net.WebRequest.

Примечание

Чтобы получить или задать значения для свойств клиентского API-интерфейса, необходимо вызвать методы доступа к свойствам с префиксами имен get_ и set_.Например, чтобы получить или задать значение свойства, такого как cancel, следует вызвать метод get_cancel или set_cancel соответственно.

var executor = MyWebRequest.get_executor();
myRequest.set_Executor(value);

Параметры

Параметр

Описание

value

Экземпляр класса, который является производным от Sys.Net.WebRequestExecutor.

Возвращаемое значение

Текущий экземпляр WebRequestExecutor.

Исключения

Тип исключения

Атрибут Condition

Sys.ArgumentNullException

Параметр value не может принимать значение NULL.

Sys.InvalidOperationException

Исполнитель веб-запросов был задан после того, как он был включен.

Sys.ArgumentException

Параметр value — недопустимый тип WebRequestExecutor.

Заметки

После завершения выполнения экземпляра WebRequest свойство executor возвращает активного сетевого выполнителя для этого запроса. С помощью соответствующего выполнителя веб-запросов можно программными средствами получить доступ к экземпляру WebRequest.

Свойство executor следует задавать только в том случае, если необходимо использовать настраиваемый сетевой выполнитель. Если это свойство не задано, система использует установленный по умолчанию выполнитель Sys.Net.XmlHttpExecutor, заданный после вызова метода invoke.

Свойство executor задать невозможно, если для экземпляра WebRequest уже существует выполнитель и веб-запрос уже запущен. Если выполняется попытка задать свойство executor с помощью выполнителя, который уже связан с экземпляром запроса, например myRequest.set_executor(myRequest.get_executor()), то возникает исключение.

Пример

В следующем примере показано, как задать выполнитель. Данный пример кода является частью полного примера, приведенного в общих сведениях о классе WebRequest.

// This function sets the Web request
// executor, replacing the default one.
function WebRequestExecutor()
{     
    // Instantiate the WebRequest.
    var wRequest =  new Sys.Net.WebRequest();

    // Create the executor. In this case it is an
    // XMLHttpExecutor, equivalent to the default
    // executor. But, you can create a custom one.
    var executor = new Sys.Net.XMLHttpExecutor();

    // Set the executor, replacing the default one. 
    // In this case the executor is equivalent to the
    // default one.
    wRequest.set_executor(executor); 

    // Get the current executor       
    var executor =  
        wRequest.get_executor();

    alert("Response availabe: " + executor.get_responseAvailable())
}

См. также

Ссылки

Класс Sys.Net.WebRequestManager

Класс Sys.Net.WebRequestExecutor

Класс Sys.Net.XMLHttpExecutor