Share via


userContext, propriété de Sys.Net.WebRequest

Mise à jour : novembre 2007

Obtient ou définit le contexte d'utilisateur associé à l'instance Sys.Net.WebRequest.

Remarque :

Pour obtenir ou définir des valeurs de propriété pour les propriétés API clientes, vous devez appeler des méthodes d'accesseur de propriété dont le nom contient les préfixes get_ et set_. Par exemple, pour obtenir ou définir la valeur d'une propriété telle que cancel, vous appelez la méthode get_cancel ou set_cancel.

var userContext = MyWebRequest.get_userContext();
MyWebRequest.set_userContext(value);

Paramètres

Paramètre

Description

Value

Les informations de contexte d'utilisateur associées à la requête value peuvent être null ou tout type de primitive ou objet JavaScript.

Valeur de retour

Contexte d'utilisateur actuel de la requête Web.

Notes

La propriété userContext peut être définie sur l'instance WebRequest avant que sa méthode d'appel soit appelée. Il est possible d'accéder à cette même propriété userContext dans le gestionnaire terminé de la requête Web. Cela permet de reconnaître les différents appelants du gestionnaire d'événements ou de récupérer un état ou un contexte lors du traitement des données retournées.

Remarque :

Pour obtenir le userContext à partir du gestionnaire d'événements, utilisez le userContext du webRequest, propriété de Sys.Net.WebRequestExecutor.

Exemple

L'exemple suivant indique comment définir le contexte d'utilisateur pour la requête Web. Ce code fait partie d'un exemple complet fourni dans la vue d'ensemble de la classe WebRequest.

// Set user's context
wRequest.set_userContext("user's context");

Voir aussi

Référence

Sys.Net.WebRequestManager, classe

Sys.Net.WebRequestExecutor, classe

Sys.Net.XMLHttpExecutor, classe