timeout, propriété de Sys.Net.WebRequest

Mise à jour : novembre 2007

Obtient ou définit la valeur du délai d'attente pour l'instance Sys.Net.WebRequest.

Remarque :
Pour obtenir ou définir des valeurs de propriété pour les propriétés API clientes, vous devez appeler des méthodes d'accesseur de propriété dont le nom contient les préfixes get_ et set_. Par exemple, vous appelez la méthode get_cancel ou set_cancel pour obtenir ou définir la valeur d'une propriété telle que Cancel.

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

Paramètres

Valeur de retour

Valeur du délai d'attente de la requête Web actuelle en millisecondes.

Exceptions

Notes

La propriété timeout représente l'intervalle de temps que l'exécuteur réseau associé à l'instance WebRequest doit attendre pour cette requête réseau.

En définissant un délai d'attente, vous vous assurez qu'un appel réseau en attente retourne de manière fiable un contrôle, au lieu d'attendre que la pile des appels réseau sous-jacente ne fasse expirer la requête. L'exécuteur réseau interprète une valeur de zéro pour signifier que le délai d'attente est de la responsabilité de la pile des appels réseau sous-jacente.

Exemple

L'exemple suivant montre comment définir et obtenir la valeur du délai d'attente d'une requête. Ce code fait partie d'un exemple complet disponible dans la vue d'ensemble de la classe 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();       
}

Voir aussi

Référence

Sys.Net.WebRequestManager, classe

Sys.Net.WebRequestExecutor, classe

Sys.Net.XMLHttpExecutor, classe