Sys.Net.XmlHttpExecutor abort-Methode

Aktualisiert: November 2007

Beendet den anstehenden vom Executor ausgegebenen Netzwerkaufruf.

MyExecutor.abort();

Ausnahmen

Hinweise

Nachdem eine Webanforderung beendet wurde, wird der anstehende Timeoutzeitgeber abgebrochen.

Beim Aufruf von abort legt der Executor die aborted-Eigenschaft auf true fest. Dies bedeutet, dass die get_started-Methode und die get_aborted-Methode der XmlHttpExecutor-Instanz beide true zurückgeben.

Anschließend ruft die WebRequestManager-Instanz den abgeschlossenen Ereignishandler des zugeordneten Anforderungsobjekts auf. Nach dem Aufruf der abort-Methode ist der Zustand der von den Executormethoden zurückgegebenen Antwort nicht definiert.

Sie können die abort-Methode mehrfach aufrufen. Der zweite und nachfolgende Aufrufe werden jedoch nicht verarbeitet. Der abgeschlossene Ereignishandler wird nur einmal ausgelöst.

Wenn Sie die abort-Methode vor der executeRequest-Methode aufrufen, wird eine Ausnahme ausgelöst.

Beispiel

Im folgenden Beispiel wird gezeigt, wie eine Webanforderung mit der abort-Methode beendet wird. Dieser Code ist Teil eines vollständigen Beispiels, das in der Übersicht über die Sys.Net.XmlHttpExecutor-Klasse enthalten ist.

// This function aborts a Web request.
function AbortWebRequest()
{
    // Create the WebRequest object.
    wRequest =  new Sys.Net.WebRequest();

    // Set the request Url.  
    wRequest.set_url("getTarget.htm");

   // Clear the results area.
    resultElementId.innerHTML = "";

    // Set the Completed event handler, 
    // for processing return data
    wRequest.add_completed(OnCompleted);

    // Make the request.
    wRequest.invoke();

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


    // Abort the request.
    executor.abort();

    // Check if the executor is aborted.
    var execAborted = 
        executor.get_aborted();

    alert("Executor aborted: " + execAborted);
}

Siehe auch

Referenz

Sys.Net.WebRequestManager-Klasse

Sys.Net.WebRequestExecutor-Klasse

Sys.Net.XMLHttpExecutor-Klasse

Weitere Ressourcen

Sprachreferenz