abort, méthode de Sys.Net.XmlHttpExecutor

Mise à jour : novembre 2007

Arrête l'appel réseau en attente émis par l'exécuteur.

MyExecutor.abort();

Exceptions

Notes

Après l'arrêt d'une requête Web, la minuterie du délai d'expiration en attente est annulée.

Lorsque abort est appelée, l'exécuteur affecte à la propriété aborted la valeur true. Cela signifie que les méthodes get_started et get_aborted de l'instance de XmlHttpExecutor retournent toutes deux la valeur true.

L'instance de WebRequestManager appelle ensuite le gestionnaire d'événements terminés de l'objet de requête associé. Après l'appel de la méthode abort, l'état de la réponse retournée par les méthodes de l'exécuteur n'est pas défini.

Vous pouvez appeler la méthode abort plusieurs fois. Toutefois, le deuxième appel et les appels suivants ne sont pas traités. Le gestionnaire d'événements terminés est déclenché une seule fois.

Si vous appelez la méthode abort avant d'appeler la méthode executeRequest, une exception est levée.

Exemple

L'exemple suivant indique comment arrêter une requête Web à l'aide de la méthode abort. Ce code fait partie d'un exemple complet fourni dans la vue d'ensemble de la classe Sys.Net.XmlHttpExecutor.

// 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);
}

Voir aussi

Référence

Sys.Net.WebRequestManager, classe

Sys.Net.WebRequestExecutor, classe

Sys.Net.XMLHttpExecutor, classe

Autres ressources

Référence du langage