executeRequest, méthode de Sys.Net.WebRequestExecutor
Mise à jour : novembre 2007
Demande à l'exécuteur d'exécuter une requête Web.
MyExecutor.executeRequest();
Notes
Lorsque cette méthode est appelée, l'exécuteur empaquette le contenu de l'instance de la requête Web et initie le traitement.
Cette méthode est destinée à être utilisée par un exécuteur personnalisé. Si vous implémentez un exécuteur personnalisé, instanciez l'exécuteur, assignez-le à l'instance de la requête Web, puis appelez la méthode sur l'instance d'exécuteur.
Les phases principales du cycle de vie d'un exécuteur relatives à la méthode executeRequest s'organisent comme suit :
L'exécuteur est créé et initialisé.
executeRequest est appelée et effectue les opérations suivantes :
Configure les caractéristiques propres à un appel réseau ou à un autre traitement.
Assigne un gestionnaire d'événements à l'objet de requête.
Configure la boucle de délai d'attente de contexte ou l'observateur de ce délai.
Effectue un appel asynchrone de l'implémentation XmlHttpRequest du navigateur pour distribuer la requête au serveur.
Une instance d'exécuteur est en mémoire pendant que la requête progresse de façon asynchrone sur le serveur. La requête se termine de l'une des manières suivantes :
L'exécuteur définit son état sur complete et déclenche l'événement completed de l'objet WebRequest associé.
L'exécuteur définit son état sur timedout et déclenche l'événement completed de l'objet WebRequest associé.
L'exécuteur définit son état sur aborted et déclenche l'événement completed de l'objet WebRequest associé.
À ce stade, l'exécuteur n'est plus nécessaire : vous pouvez l'ignorer en appelant sa méthode dispose.
Exemple
L'exemple suivant montre comment effectuer une requête Web à l'aide de la méthode executeRequest.
// This function executes a Web request.
function ExecuteWebRequest()
{
// Create the WebRequest object.
wRequest = new Sys.Net.WebRequest();
// Set the request Url.
wRequest.set_url("getTarget.htm");
// Set the Completed event handler, for processing return data
wRequest.add_completed(OnCompleted);
// Clear the results area.
resultElementId.innerHTML = "";
// To use executeRequest you must instantiate the
// executor, assign it to the Web request instance,
// then call the executeRequest function.
// Note: Normally to make a Web request you use
// the invoke method of the WebRequest instance.
var executor = new Sys.Net.XMLHttpExecutor();
wRequest.set_executor(executor);
executor.executeRequest();
var started = executor.get_started();
alert("Executor started: " + started);
}