add_completed, méthode de Sys.Net.WebRequest

Mise à jour : novembre 2007

Inscrit un gestionnaire pour l'événement de requête terminée de la requête Web.

MyWebRequest.add_completed(handler);

Arguments

Notes

L'exécuteur associé à la requête Web déclenche l'événement de requête terminée en appelant la méthode completed. La fonction gestionnaire est appelée pour traiter les données retournées lorsque le travail effectué par l'exécuteur associé est terminé. Notez que l'achèvement ne signifie pas forcément succès. Un exécuteur termine sa tâche avec l'un des trois états suivants : terminé, interrompu ou expiré.

La fonction de gestionnaire d'événements inscrite doit accepter deux paramètres :

• Une référence à l'exécuteur qui a publié la requête réseau. Vous pouvez accéder à l'exécuteur pour vérifier son état et récupérer les données de réponse.

• Un paramètre eventArgs défini par l'exécuteur qui a déclenché l'événement de requête terminée. Pour les exécuteurs par défaut, cet argument a la valeur Sys.EventArgs.empty, propriété.

Le gestionnaire d'événements peut déterminer l'état de l'exécuteur en utilisant l'une des propriétés d'exécuteur suivantes : responseAvailable, aborted ou timedOut.

Le gestionnaire d'événements peut accéder à d'autres informations de réponse à propos de l'exécuteur uniquement si responseAvailable retourne la valeur true.

Exemple

L'exemple suivant montre comment ajouter et supprimer le gestionnaire d'événements terminés. Ce code fait partie d'un exemple complet fourni dans la vue d'ensemble de la classe WebRequest.

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

Voir aussi

Référence

Sys.Net.WebRequestManager, classe

Sys.Net.WebRequestExecutor, classe

Sys.Net.XMLHttpExecutor, classe