Partager via


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

Mise à jour : novembre 2007

Obtient ou définit le verbe HTTP utilisé par la classe Sys.Net.WebRequest pour publier la requête Web.

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 une valeur pour une propriété telle que cancel, vous appelez les méthodes get_cancel ou set_cancel.

var verb = MyWebRequest.get_httpVerb();
MyWebRequest.set_httpVerb(value);

Paramètres

Paramètre

Description

value

Chaîne qui contient le verbe HTTP pour la requête Web. value doit être un verbe HTTP reconnu par le serveur Web, tel que "GET" ou "POST".

Valeur de retour

Verbe de la requête Web actuelle.

Exceptions

Type d'exception

Condition

Sys.ArgumentException

value ne peut pas être null ni une chaîne vide ("").

Notes

Si le verbe HTTP n'a pas été défini précédemment, la valeur de propriété httpVerb est déterminée selon la logique suivante :

  • Si la valeur de la propriété body est null, l'instance WebRequest retourne "GET".

  • Si la valeur de la propriété body n'est pas null, l'instance WebRequest retourne "POST". Si le corps retourné est une chaîne vide (""), il est considéré comme non null et "POST" est retourné.

Exemple

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

// Set the request verb.
wRequest.set_httpVerb("POST");

Voir aussi

Référence

Sys.Net.WebRequestManager, classe

Sys.Net.WebRequestExecutor, classe

Sys.Net.XMLHttpExecutor, classe