Sys.Net.WebRequestManager defaultTimeout-Eigenschaft

Artikel
09/03/2008

Aktualisiert: November 2007

Ruft das Timeout für den standardmäßigen Netzwerkexecutor ab oder legt es 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 dTimeout = Sys.Net.WebRequestManager.get_defaultTimeout ();
Sys.Net.WebRequestManager.set_defaultTimeout(value);

Parameter

Parameter	Beschreibung
value	Die Zeit in Millisekunden, die der Standardexecutor auf das Timeout einer Webanforderung warten muss. Dieser Wert muss 0 oder eine positive ganze Zahl sein.

Rückgabewert

Ein ganzzahliger Wert, der das aktuelle Timeout für den Standardexecutor angibt.

Ausnahmen

Ausnahmetyp	Bedingung
Sys.ArgumentOutOfRangeException	Ein ungültiger Parameter wurde übergeben.

Hinweise

Verwenden Sie die defaultTimeout-Eigenschaft, um die Zeit in Millisekunden abzurufen oder festzulegen, die der Standardexecutor auf das Timeout einer Webanforderung warten sollte.

Indem Sie einen Timeoutwert ungleich 0 (null) festlegen, stellen Sie sicher, dass eine anstehende Webanforderung die Steuerung rechtzeitig an den Aufrufer zurückgibt.

Beispiel

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

// Gets and sets the default timeout.
function DefaultTimeout()
{
    // Clear the previous results. 
    resultElement.innerHTML = "";

    // Get system default timeout.
    var sysDefaultTimeout = 
        Sys.Net.WebRequestManager.get_defaultTimeout();

    alert("Get default timeout: " + sysDefaultTimeout);


    // Set custom default timeout.
    Sys.Net.WebRequestManager.set_defaultTimeout(100);

    var customDefaultTimeout = 
        Sys.Net.WebRequestManager.get_defaultTimeout();

    alert("Set default timeout: " + customDefaultTimeout);


    // Set the timeout back to the system default. 
    Sys.Net.WebRequestManager.set_defaultTimeout(
    sysDefaultTimeout);    

}