Sys.Net.WebRequest timeout 属性

更新：2007 年 11 月

获取或设置 Sys.Net.WebRequest 实例的超时值。

说明：
若要获取或设置客户端 API 属性的属性值，必须调用以 get_ 和 set_ 为名称前缀的属性访问器方法。例如，若要获取或设置属性 cancel 的值，需要调用 get_cancel 或 set_cancel 方法。

var timeout = MyWebRequest.get_timeout();
MyWebRequest.set_timeout(value);

参数

返回值

当前的 Web 请求超时值（以毫秒为单位）。

异常

备注

timeout 属性表示与 WebRequest 实例关联的网络执行器在使网络请求超时之前所等待的时间间隔。

通过设置超时间隔，可以确保挂起的网络调用能够可靠地返回控制，而不是等待基础网络堆栈使请求超时。网络执行器将值 0 解释为由基础网络堆栈负责使请求超时。

示例

下面的示例演示如何设置和获取请求超时值。此代码摘自 WebRequest 类概述中的一个完整示例。

// This function gets and sets the 
// Web request time out.
function WebRequestTimeout()
{     
    // Instantiate the WebRequest.
    var wRequest =  new Sys.Net.WebRequest();

    // Set the request Url.  
    wRequest.set_url(getPage);  

    var defaultTimeout =  
        wRequest.get_timeout();

    // Set request timeout to 100 msec.
    wRequest.set_timeout(100);

    var newTimeout = 
        wRequest.get_timeout();

    alert("Default timeout: " + defaultTimeout);
    alert("New timeout: " + newTimeout);

    // Set the web request completed event handler,
    // for processing return data.
    wRequest.add_completed(OnWebRequestCompleted);   

    // Execute the request.
    wRequest.invoke();       
}

请参见

参考

Sys.Net.WebRequestManager 类

Sys.Net.WebRequestExecutor 类

Sys.Net.XMLHttpExecutor 类