Sys.Net.WebRequestManager defaultExecutor-Eigenschaft

Artikel
09/03/2008

Aktualisiert: November 2007

Ruft den Standardtyp des für Netzwerkanforderungen verwendeten Netzwerkexecutors ab oder legt ihn 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 dExecutor = Sys.WebRequestManager.get_defaultExecutorType ();
Sys.Net.WebRequestManager.set_defaultExecutorType(value);

Parameter

Parameter	Beschreibung
value	Ein Verweis auf eine Implementierung der WebRequestExecutor-Klasse.

Ausnahmen

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

Rückgabewert

Das Objekt, das den standardmäßigen Webanforderungsexecutor darstellt.

Hinweise

Verwenden Sie die defaultExecutor-Eigenschaft zum Abrufen oder Festlegen des Standardexecutors, der einen Verweis auf das aktuelle WebRequestExecutor-Objekt darstellt.

Wenn das WebRequestExecutor-Objekt bereit ist, eine Webanforderung an den Executor zu senden, verwendet es den von Ihnen bereitgestellten Anforderungsexecutor. Wenn Sie keinen Executor bereitstellen, erstellt WebRequestExecutor eine Instanz der XmlHttpExecutor-Klasse.

Beispiel

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

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

    // Get system default executor type.
    var sysDefaultExecutor = 
        Sys.Net.WebRequestManager.get_defaultExecutorType();
    alert("Get default executor:" + sysDefaultExecutor);


    // Modify the default executor type.
    Sys.Net.WebRequestManager.set_defaultExecutorType(
    "Sys.Net.CustomExecutor");

    var customDefaultExecutor = 
        Sys.Net.WebRequestManager.get_defaultExecutorType();

    alert("Set default executor: " + customDefaultExecutor);

    // Set the executor back to the system default. This is 
    // to allow the WebRequest script to run.
    executor = "Sys.Net.XMLHttpExecutor";
    Sys.Net.WebRequestManager.set_defaultExecutorType(
    sysDefaultExecutor);    

}

Siehe auch

Referenz

Sys.Net.WebRequestManager-Klasse

Sys.Net.WebRequestExecutor-Klasse

Sys.Net.XMLHttpExecutor-Klasse

Freigeben über