Sys.Net.WebRequest add_completed-Methode

Artikel
09/03/2008

Aktualisiert: November 2007

Registriert einen Handler für das abgeschlossene Anforderungsereignis der Webanforderung.

MyWebRequest.add_completed(handler);

Argumente

Ausdruck	Definition
handler	Die zur Behandlung des abgeschlossenen Anforderungsereignisses registrierte Funktion.

Hinweise

Der der Webanforderung zugeordnete Executor löst das abgeschlossene Anforderungsereignis aus, indem er die completed-Methode aufruft. Die Handlerfunktion wird zur Verarbeitung zurückgegebener Daten aufgerufen, nachdem die vom zugeordneten Executor ausgeführten Aufgaben abgeschlossen sind. Beachten Sie, dass ein Abschluss nicht gleichzeitig einen erfolgreichen Abschluss bedeutet. Ein Executor beendet seine Arbeit mit einem von drei Zuständen: abgeschlossen, abgebrochen oder Zeitlimit überschritten.

Die registrierte Ereignishandlerfunktion muss zwei Parameter akzeptieren:

Einen Verweis auf den Executor, der die Netzwerkanforderung ausgegeben hat. Sie können auf den Executor zugreifen, um dessen Status zu überprüfen und die Antwortdaten abzurufen.
Einen eventArgs-Parameter, der vom Executor festgelegt wird, der das abgeschlossene Anforderungsereignis ausgelöst hat. Für Standardexecutors wird dieses Argument auf Sys.EventArgs.empty-Eigenschaft festgelegt.

Der Ereignishandler kann den Zustand des Executors mit einer der folgenden Executoreigenschaften ermitteln: responseAvailable, aborted oder timedOut.

Auf andere Antwortinformationen über den Executor kann der Ereignishandler nur zugreifen, wenn responseAvailable den Wert true zurückgibt.

Beispiel

Das folgende Beispiel zeigt, wie der abgeschlossene Ereignishandler hinzugefügt und entfernt wird. Dieser Code ist Teil eines vollständigen Beispiels, das in der Übersicht über die WebRequest-Klasse enthalten ist.

// This function adds and removes the 
// Web request completed event handler.
function WebRequestCompleted()
{    
    // Instantiate the WebRequest.
    var wRequest =  new Sys.Net.WebRequest();

    // Set the request Url.  
    wRequest.set_url(getPage);  

    // Set the web request completed event handler,
    // for processing return data.
    wRequest.add_completed(OnWebRequestCompleted);   
    alert("Added Web request completed handler");

    // Remove the web request completed event handler.
    // Comment the following two lines if you want to
    // use the handler.
    wRequest.remove_completed(OnWebRequestCompleted); 
    alert("Removed handler; the Web request return is not processed.");

    // Execute the request.
    wRequest.invoke();  
}

Siehe auch

Referenz

Sys.Net.WebRequestManager-Klasse

Sys.Net.WebRequestExecutor-Klasse

Sys.Net.XMLHttpExecutor-Klasse

Freigeben über