Sys.Net.WebRequest executor 属性

更新:2007 年 11 月

获取或设置与 Sys.Net.WebRequest 实例关联的执行器。

说明:

若要获取或设置客户端 API 属性的属性值,必须调用以 get_set_ 为名称前缀的属性访问器方法。例如,若要获取或设置属性 cancel 的值,需要调用 get_cancelset_cancel 方法。

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

参数

参数

说明

value

Sys.Net.WebRequestExecutor 派生的类的实例。

返回值

当前的 WebRequestExecutor 实例。

异常

异常类型

条件

Sys.ArgumentNullException

value 不能为 null。

Sys.InvalidOperationException

执行器在启用之后才设置。

Sys.ArgumentException

value 不是有效的 WebRequestExecutor 类型。

备注

WebRequest 实例完成执行后,executor 属性返回与该请求关联的活动网络执行器。在关联的执行器中,可以以编程方式访问 WebRequest 实例。

仅当需要自定义网络执行器时,才应设置 executor 属性。如果不设置此属性,系统将使用默认的 Sys.Net.XmlHttpExecutor 执行器,它是在调用 invoke 方法之后设置的。

如果 WebRequest 实例已有关联的执行器,并且 Web 请求已经发出,则无法设置 executor 属性。如果试图使用已与请求实例关联的执行器来设置 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 类