Sys.Net.WebRequestManager add_completedRequest-Methode
Aktualisiert: November 2007
Registriert einen Handler für das abgeschlossene Anforderungsereignis von WebRequestManager.
Sys.Net.WebRequestManager.add_completedRequest(handler);
Parameter
Parameter |
Beschreibung |
|---|---|
Handler |
Die zur Behandlung des abgeschlossenen Anforderungsereignisses registrierte Funktion. |
Hinweise
Dieses abgeschlossene Anforderungsereignis wird ausgelöst, nachdem die Anforderung ausgeführt wurde und zur Verarbeitung von Rückgabedaten verwendet wird. Verwenden Sie die add_completedRequest-Methode zum Festlegen der JavaScript-Funktion, die das WebRequestManager-Objekt nach Abschluss der Webanforderung verwenden muss. Das WebRequestManager-Objekt gibt dieses Ereignis aus, bevor Ereignisse zum Abschluss der WebRequest-Instanz auftreten. Nachdem der Netzwerkaufruf vom Netzwerkexecutor ausgeführt wurde (was zu einem erfolgreichen Abschluss, einem Abbruch oder einem Timeout führen kann), wird zuerst der von Ihnen hinzugefügte Handler ausgeführt. Nachdem Ihr Ereignishandler beendet wurde, wird der ursprüngliche Ereignishandler der WebRequest-Instanz ausgeführt.
Mit diesem Ereignis können Sie die vom Executor zurückgesendeten Daten überprüfen oder protokollieren.
Ihr Ereignishandler muss über die folgende Signatur verfügen:
function OnWebRequestComplete(sender, eventArgs) {}
Der sender-Parameter wird auf die WebRequestExecutor-Instanz festgelegt, die das abgeschlossene Ereignis ausgelöst hat.
Das eventArgs-Argument wird von dem Executor festgelegt, der das abgeschlossene Ereignis ausgelöst hat. Bei Microsoft-Executors lautet dieses Argument immer EventArgs.Empty. Benutzerdefinierte Executors können jedoch auch andere Werte festlegen.
Beispiel
Im folgenden Beispiel wird gezeigt, wie ein Ereignis hinzugefügt wird, das nach der Ausführung der Webanforderung ausgegeben werden soll. Es veranschaulicht auch, wie der zugehörige Ereignishandler festgelegt wird. Dieser Code ist Teil eines vollständigen Beispiels, das in der Übersicht über die WebRequestManager-Klasse enthalten ist.
// Set the handler to process the Web request.
Sys.Net.WebRequestManager.add_completedRequest(On_WebRequestCompleted);
Siehe auch
Referenz
Sys.Net.WebRequestManager-Klasse