Sys.Net.WebRequest timeout-Eigenschaft

Artikel
09/03/2008

Aktualisiert: November 2007

Ruft den Timeoutwert für die Sys.Net.WebRequest-Instanz ab oder legt sie fest.

Tipp

Um Eigenschaftenwerte für Client-API-Eigenschaften abzurufen oder festzulegen, müssen Sie Accessormethoden für die Eigenschaften aufrufen, die mit dem Präfix get_ bzw. set_ benannt sind. Beispiel: Um einen Wert für eine Eigenschaft wie cancel abzurufen oder festzulegen, rufen Sie die get_cancel-Methode oder die set_cancel-Methode auf.

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

Parameter

Ausdruck	Definition
value	Das Timeoutintervall in Millisekunden.

Rückgabewert

Der aktuelle Timeoutwert für die Webanforderung in Millisekunden.

Ausnahmen

Ausnahmetyp	Bedingung
Sys.ArgumentOutOfRangeException	value muss eine nicht negative ganze Zahl sein.

Hinweise

Die timeout-Eigenschaft stellt das Zeitintervall dar, das der der WebRequest-Klasse zugeordnete Netzwerkexecutor warten soll, bevor das Zeitlimit der Netzwerkanforderung überschritten wird.

Indem Sie ein Timeoutintervall festlegen, stellen Sie sicher, dass ein ausstehender Netzwerkaufruf die Steuerung zuverlässig zurückgibt, anstatt darauf zu warten, dass das Zeitlimit des zugrunde liegenden Netzwerkstapel für die Anforderung abläuft. Bei einem Nullwert geht der Netzwerkexecutor davon aus, dass das Timeout in der Verantwortung des zugrunde liegenden Netzwerkstapels liegt.

Beispiel

Das folgende Beispiel zeigt, wie der Timeoutwert für die Anforderung festgelegt und abgerufen wird. Dieser Code ist Teil eines vollständigen Beispiels, das in der Übersicht über die WebRequest-Klasse enthalten ist.

// 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();       
}

Siehe auch

Referenz

Sys.Net.WebRequestManager-Klasse

Sys.Net.WebRequestExecutor-Klasse

Sys.Net.XMLHttpExecutor-Klasse

Freigeben über