更新:2007 年 11 月
获取或设置与 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 实例。
异常
异常类型 |
条件 |
|---|---|
value 不能为 null。 |
|
执行器在启用之后才设置。 |
|
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())
}
说明: