Partager via


add_invokingRequest, méthode de Sys.Net.WebRequestManager

Mise à jour : novembre 2007

Inscrit un gestionnaire pour traiter l'événement de requête appelant du WebRequestManager.

Sys.Net.WebRequestManager.add_invokingRequest(handler);

Paramètres

Paramètre

Description

handler

Fonction enregistrée pour gérer l'événement de requête appelant.

Notes

Utilisez la méthode add_invokingRequest pour définir une fonction que la classe WebRequestManager doit appeler avant de router la requête Web vers l'exécuteur. Cet événement vous permet d'inspecter les requêtes Web dirigées vers le WebRequestManager. Vous pouvez utiliser cet événement pour effectuer les tâches suivantes :

  • audit des requêtes réseau sortantes ;

  • interception et annulation sélective des requêtes Web ;

  • traitement des requêtes Web à l'aide d'une logique personnalisée plutôt que de la construction d'exécuteur. Par exemple, vous pouvez définir un service de stockage local afin d'intercepter chaque requête et de créer des données de réponse à partir d'un magasin local au lieu de laisser les requêtes parcourir le réseau.

Votre gestionnaire d'événements doit avoir la signature suivante :

function OnInvokingRequest(sender, networkRequestEventArgs){} 

Le paramètre Sender a pour valeur l'instance WebRequestManager.

Exemple

L'exemple suivant indique comment ajouter un événement à publier avant l'exécution de la requête Web. Ce code fait partie d'un exemple complet se trouvant dans la vue d'ensemble de la classe WebRequestManager.

// Set the handler to call before the Web request
// is executed.
Sys.Net.WebRequestManager.add_invokingRequest(On_InvokingRequest);   

Voir aussi

Référence

Sys.Net.WebRequestManager, classe

Sys.Net.WebRequestExecutor, classe

Sys.Net.XMLHttpExecutor, classe