HTTP

.NET Framework offre une prise en charge complète du protocole HTTP, qui constitue la majeure partie du trafic Internet, à l'aide des classes HttpWebRequest et HttpWebResponse. Ces classes, dérivées de WebRequest et WebResponse, sont retournées par défaut, chaque fois que la méthode statique WebRequest.Create rencontre un URI commençant par "http" ou "https". En général, les classes WebRequest et WebResponse fournissent tous les éléments nécessaires à la demande. Toutefois, si vous devez accéder aux fonctionnalités spécifiques HTTP exposées en tant que propriétés, vous pouvez effectuer une conversion de type de ces classes en HttpWebRequest ou HttpWebResponse.

HttpWebRequest et HttpWebResponse encapsulent une transaction "demande et réponse" HTTP standard et permettent d'accéder aux en-têtes HTTP courants. Ces classes prennent également en charge la majorité des fonctionnalités de HTTP 1.1, notamment le pipeline, la segmentation, l'authentification, la pré-authentification, le chiffrement, la prise en charge de proxy, la validation des certificats de serveur et la gestion des connexions. Les en-têtes et en-têtes personnalisés qui ne sont pas fournis par le biais des propriétés peuvent être stockés dans la propriété Headers et sont accessibles à partir de cette propriété.

HttpWebRequest est la classe par défaut utilisée par WebRequest ; il n'est pas nécessaire de l'inscrire avant de passer un URI à la méthode WebRequest.Create.

Pour que votre application suive automatiquement les redirections HTTP, affectez la valeur True (valeur par défaut) à la propriété AllowAutoRedirect. L'application redirige alors les demandes et la propriété ResponseURI de HttpWebResponse contient la ressource Web qui a répondu à la demande. Si vous affectez la valeur False à AllowAutoRedirect, votre application doit être en mesure de gérer les redirections en tant qu'erreurs de protocole HTTP.

Les applications reçoivent les erreurs de protocole HTTP en mettant en cache une WebException, la valeur de la propriété Status étant WebExceptionStatus.ProtocolError. La propriété Response contient la WebResponse transmise par le serveur et elle indique l'erreur HTTP rencontrée.

Voir aussi

Tâches

Comment : accéder aux propriétés spécifiques au protocole HTTP

Concepts

Accès à Internet via un proxy
Utilisation de protocoles d'application