Свойство 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())
}


Показ: