Sys.Net.WebRequest executor-Eigenschaft

Artikel
09/03/2008

Aktualisiert: November 2007

Ruft den Executor der zugeordneten Sys.Net.WebRequest-Instanz 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 executor = MyWebRequest.get_executor();
myRequest.set_Executor(value);

Parameter

Parameter	Beschreibung
value	Eine Instanz einer Klasse, die von Sys.Net.WebRequestExecutor abgeleitet wird.

Rückgabewert

Die aktuelle WebRequestExecutor-Instanz.

Ausnahmen

Ausnahmetyp	Bedingung
Sys.ArgumentNullException	value darf nicht NULL sein.
Sys.InvalidOperationException	Der Executor wurde festgelegt, nachdem er aktiviert wurde.
Sys.ArgumentException	value ist kein gültiger WebRequestExecutor-Typ.

Hinweise

Nachdem die Ausführung der WebRequest-Instanz beendet wurde, gibt die executor-Eigenschaft den aktiven Netzwerkexecutor zurück, der der Anforderung zugeordnet ist. Sie können vom zugeordneten Executor aus programmgesteuert auf die WebRequest-Instanz zugreifen.

Sie legen die executor-Eigenschaft nur fest, wenn Sie einen benutzerdefinierten Netzwerkexecutor benötigen. Wenn Sie diese Eigenschaft nicht festlegen, verwendet das System den standardmäßigen Sys.Net.XmlHttpExecutor-Executor, der nach Aufrufen der invoke-Methode festgelegt wird.

Sie können die executor-Eigenschaft nicht festlegen, wenn die WebRequest-Instanz bereits über einen zugeordneten Executor verfügt und die Webanforderung bereits gesendet wurde. Wenn Sie versuchen, die executor-Eigenschaft über einen Executor festzulegen, der der Anforderungsinstanz, z. B. myRequest.set_executor(myRequest.get_executor()), bereits zugeordnet wurde, wird eine Ausnahme ausgelöst.

Beispiel

Im folgenden Beispiel wird das Festlegen des Executors veranschaulicht. Dieser Code ist Teil eines vollständigen Beispiels, das in der Übersicht über die WebRequest-Klasse enthalten ist.

// This function sets the Web request
// executor, replacing the default one.
function WebRequestExecutor()
{     
    // Instantiate the WebRequest.
    var wRequest =  new Sys.Net.WebRequest();

    // Create the executor. In this case it is an
    // XMLHttpExecutor, equivalent to the default
    // executor. But, you can create a custom one.
    var executor = new Sys.Net.XMLHttpExecutor();

    // Set the executor, replacing the default one. 
    // In this case the executor is equivalent to the
    // default one.
    wRequest.set_executor(executor); 

    // Get the current executor       
    var executor =  
        wRequest.get_executor();

    alert("Response availabe: " + executor.get_responseAvailable())
}

Siehe auch

Referenz

Sys.Net.WebRequestManager-Klasse

Sys.Net.WebRequestExecutor-Klasse

Sys.Net.XMLHttpExecutor-Klasse

Freigeben über