Sys.Net.WebRequest timeout (Propiedad)

Actualización: noviembre 2007

Obtiene o establece el valor de tiempo de espera de la instancia de Sys.Net.WebRequest.

Nota

Para obtener o establecer los valores de las propiedades de la API de cliente, debe llamar a los métodos de descriptor de acceso de propiedades cuyos nombres tienen los prefijos get_ y set_. Por ejemplo, para obtener o establecer un valor para una propiedad como cancel, llame a los métodos get_cancel o set_cancel.

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

Parámetros

Término	Definition
value	Intervalo de tiempo en milisegundos.

Valor devuelto

Valor de tiempo de espera de la solicitud web actual en milisegundos.

Excepciones

Tipo de excepción	Condition
Sys.ArgumentOutOfRangeException	value debe ser un entero no negativo.

Comentarios

La propiedad timeout representa el intervalo de tiempo que el elemento de ejecución de red asociado a la instancia de WebRequest espera antes de que se agote el tiempo de espera de la solicitud de red.

Mediante un intervalo de tiempo de espera, puede asegurarse de que una llamada de red pendiente devuelva el control, en lugar de esperar a que la pila de la red establezca que se ha agotado el tiempo de espera de la solicitud. El elemento de ejecución de red interpreta que un valor de cero indica que es responsabilidad de la pila de red subyacente establecer que se ha agotado el tiempo de espera.

Ejemplo

En el ejemplo siguiente se muestra cómo establecer y obtener el valor de tiempo de espera de la solicitud. Este código forma parte de un ejemplo completo que se encuentra en la información general de la clase 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();       
}

Vea también

Referencia

Sys.Net.WebRequestManager (Clase)

Sys.Net.WebRequestExecutor (Clase)

Sys.Net.XMLHttpExecutor (Clase)