HttpWebRequest Classe

Définition

Espace de noms:

System.Net

Assemblys:

netstandard.dll, System.Net.Requests.dll

Source:

HttpWebRequest.cs

Fournit une implémentation http spécifique à la WebRequest classe.

public ref class HttpWebRequest : System::Net::WebRequest, System::Runtime::Serialization::ISerializable

public class HttpWebRequest : System.Net.WebRequest, System.Runtime.Serialization.ISerializable

type HttpWebRequest = class
    inherit WebRequest
    interface ISerializable

Public Class HttpWebRequest
Inherits WebRequest
Implements ISerializable

Héritage

Object

MarshalByRefObject

WebRequest

HttpWebRequest

Implémente

ISerializable

Exemples

L’exemple de code suivant crée un HttpWebRequest URI http://www.contoso.com/.

HttpWebRequest myReq =
(HttpWebRequest)WebRequest.Create("http://www.contoso.com/");

Dim myReq As HttpWebRequest = _
    WebRequest.Create("http://www.contoso.com/")

Remarques

Prudence

WebRequest, , HttpWebRequestServicePointet sont obsolètes, et WebClient vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

La HttpWebRequest classe prend en charge les propriétés et méthodes définies dans WebRequest et pour les propriétés et méthodes supplémentaires qui permettent à l’utilisateur d’interagir directement avec des serveurs à l’aide de HTTP.

N’utilisez pas le HttpWebRequest constructeur. Utilisez la WebRequest.Create méthode pour initialiser de nouveaux HttpWebRequest objets. Si le schéma de l’URI (Uniform Resource Identifier) est http:// ou https://, Create retourne un HttpWebRequest objet.

La GetResponse méthode effectue une requête synchrone à la ressource spécifiée dans la RequestUri propriété et retourne un HttpWebResponse objet de réponse. Les données de réponse peuvent être reçues à l’aide du flux retourné par GetResponseStream. Si l’objet réponse ou le flux de réponse est fermé, les données restantes sont perdues. Les données restantes seront vidées et le socket sera réutilisé pour les demandes suivantes lors de la fermeture de l’objet ou du flux de réponse si les conditions suivantes contiennent : il s’agit d’une demande de conservation ou de pipeline, seule une petite quantité de données doit être reçue, ou les données restantes sont reçues dans un petit intervalle de temps. Si aucune des conditions mentionnées n’est conservée ou si le temps de drainage n’est dépassé, le socket est fermé. Pour les connexions continues ou pipelines, nous vous recommandons vivement de lire les flux jusqu’à ce que l’EOF soit lu. Cela garantit que le socket sera réutilisé pour les requêtes suivantes, ce qui entraînera de meilleures performances et moins de ressources utilisées.

Lorsque vous souhaitez envoyer des données à la ressource, la GetRequestStream méthode retourne un Stream objet à utiliser pour envoyer des données. Les BeginGetRequestStream méthodes et EndGetRequestStream fournissent un accès asynchrone au flux de données d’envoi.

Pour l’authentification du client avec HttpWebRequest, le certificat client doit être installé dans le magasin de certificats My de l’utilisateur actuel.

La HttpWebRequest classe lève une WebException erreur lorsque des erreurs se produisent lors de l’accès à une ressource. La WebException.Status propriété contient une WebExceptionStatus valeur qui indique la source de l’erreur. Quand WebException.Status c’est WebExceptionStatus.ProtocolErrorle cas, la Response propriété contient la HttpWebResponse propriété reçue de la ressource.

HttpWebRequest expose les valeurs d’en-tête HTTP courantes envoyées à la ressource Internet en tant que propriétés, définies par méthodes ou définies par le système ; le tableau suivant contient une liste complète. Vous pouvez définir d’autres en-têtes dans la Headers propriété en tant que paires nom/valeur. Notez que les serveurs et les caches peuvent modifier ou ajouter des en-têtes pendant la demande.

Le tableau suivant répertorie les en-têtes HTTP définis par les propriétés ou les méthodes ou le système.

En-tête	Défini par
Accept	Défini par la Accept propriété.
Connection	Défini par la Connection propriété, KeepAlive propriété.
Content-Length	Défini par la ContentLength propriété.
Content-Type	Défini par la ContentType propriété.
Expect	Défini par la Expect propriété.
Date	Défini par le système sur la date actuelle.
Host	Défini par le système sur les informations d’hôte actuelles.
If-Modified-Since	Défini par la IfModifiedSince propriété.
Range	Défini par la AddRange méthode.
Referer	Défini par la Referer propriété.
Transfer-Encoding	Défini par la TransferEncoding propriété (la SendChunked propriété doit être true).
User-Agent	Défini par la UserAgent propriété.

Note

HttpWebRequest est inscrit automatiquement. Vous n’avez pas besoin d’appeler la RegisterPrefix méthode pour s’inscrire System.Net.HttpWebRequest avant d’utiliser des URI commençant par http:// ou https://.

Le fichier de configuration de l’ordinateur local ou de l’application peut spécifier qu’un proxy par défaut doit être utilisé. Si la Proxy propriété est spécifiée, les paramètres proxy de la Proxy propriété remplacent le fichier de configuration de l’ordinateur local ou de l’application. L’instance HttpWebRequest utilise les paramètres de proxy spécifiés. Si aucun proxy n’est spécifié dans un fichier de configuration et que la propriété n’est pas spécifiée, la ProxyHttpWebRequest classe utilise les paramètres de proxy hérités des options Internet sur l’ordinateur local. S’il n’existe aucun paramètre proxy dans les options Internet, la demande est envoyée directement au serveur.

Note

Framework met en cache les sessions SSL au fur et à mesure qu’elles sont créées et tente de réutiliser une session mise en cache pour une nouvelle requête, si possible. Lorsque vous tentez de réutiliser une session SSL, l’infrastructure utilise le premier élément de ClientCertificates (s’il en existe un) ou tente de réutiliser une session anonyme si ClientCertificates elle est vide.

Note

Pour des raisons de sécurité, les cookies sont désactivés par défaut. Si vous souhaitez utiliser des cookies, utilisez la CookieContainer propriété pour activer les cookies.

Pour les applications qui utilisent TLS/SSL via des API telles que HttpClient, HttpWebRequest, FTPClient, SmtpClient et SsStream, .NET bloque les algorithmes de chiffrement et de hachage non sécurisés pour les connexions par défaut. Vous devrez peut-être refuser ce comportement pour maintenir l’interopérabilité avec les services SSL3 existants OU TLS w/ RC4. Impossible de se connecter à un serveur à l’aide des API ServicePointManager ou SslStream après la mise à niveau vers .NET Framework 4.6 explique comment modifier votre code pour désactiver ce comportement, si nécessaire.

Constructeurs

Nom	Description
HttpWebRequest(SerializationInfo, StreamingContext)	Obsolète. Initialise une nouvelle instance de la HttpWebRequest classe à partir des instances spécifiées des classes et StreamingContext des SerializationInfo classes. Ce constructeur est obsolète.

Propriétés

Nom	Description
Accept	Obtient ou définit la valeur de l’en-tête Accept HTTP.
Address	Obtient l’URI (Uniform Resource Identifier) de la ressource Internet qui répond réellement à la requête.
AllowAutoRedirect	Obtient ou définit une valeur qui indique si la demande doit suivre les réponses de redirection.
AllowReadStreamBuffering	Obtient ou définit une valeur qui indique s’il faut mettre en mémoire tampon la réception de la ressource Internet.
AllowWriteStreamBuffering	Obtient ou définit une valeur qui indique s’il faut mettre en mémoire tampon les données envoyées à la ressource Internet.
AuthenticationLevel	Obtient ou définit des valeurs indiquant le niveau d’authentification et d’emprunt d’identité utilisé pour cette requête. (Hérité de WebRequest)
AutomaticDecompression	Obtient ou définit le type de décompression utilisé.
CachePolicy	Obtient ou définit la stratégie de cache pour cette requête. (Hérité de WebRequest)
ClientCertificates	Obtient ou définit la collection de certificats de sécurité associés à cette requête.
Connection	Obtient ou définit la valeur de l’en-tête Connection HTTP.
ConnectionGroupName	Obtient ou définit le nom du groupe de connexions pour la demande.
ContentLength	Obtient ou définit l’en-tête Content-length HTTP.
ContentType	Obtient ou définit la valeur de l’en-tête Content-type HTTP.
ContinueDelegate	Obtient ou définit la méthode déléguée appelée lorsqu’une réponse HTTP 100-continue est reçue de la ressource Internet.
ContinueTimeout	Obtient ou définit un délai d’expiration, en millisecondes, pour attendre que le 100-Continue soit reçu du serveur.
CookieContainer	Obtient ou définit les cookies associés à la requête.
Credentials	Obtient ou définit des informations d’authentification pour la demande.
Date	Obtient ou définit la Date valeur d’en-tête HTTP à utiliser dans une requête HTTP.
DefaultCachePolicy	Obtient ou définit la stratégie de cache par défaut pour cette requête.
DefaultMaximumErrorResponseLength	Obtient ou définit la longueur maximale par défaut d’une réponse d’erreur HTTP.
DefaultMaximumResponseHeadersLength	Obtient ou définit la valeur par défaut de la MaximumResponseHeadersLength propriété.
Expect	Obtient ou définit la valeur de l’en-tête Expect HTTP.
HaveResponse	Obtient une valeur qui indique si une réponse a été reçue d’une ressource Internet.
Headers	Spécifie une collection des paires nom/valeur qui composent les en-têtes HTTP.
Host	Obtient ou définit la valeur d’en-tête de l’hôte à utiliser dans une requête HTTP indépendante de l’URI de requête.
IfModifiedSince	Obtient ou définit la valeur de l’en-tête If-Modified-Since HTTP.
ImpersonationLevel	Obtient ou définit le niveau d’emprunt d’identité de la requête actuelle. (Hérité de WebRequest)
KeepAlive	Obtient ou définit une valeur qui indique s’il faut établir une connexion persistante à la ressource Internet.
MaximumAutomaticRedirections	Obtient ou définit le nombre maximal de redirections que la requête suit.
MaximumResponseHeadersLength	Obtient ou définit la longueur maximale autorisée des en-têtes de réponse.
MediaType	Obtient ou définit le type de média de la requête.
Method	Obtient ou définit la méthode de la requête.
Pipelined	Obtient ou définit une valeur qui indique s’il faut pipeliner la requête vers la ressource Internet.
PreAuthenticate	Obtient ou définit une valeur qui indique s’il faut envoyer un en-tête d’autorisation avec la requête.
ProtocolVersion	Obtient ou définit la version de HTTP à utiliser pour la requête.
Proxy	Obtient ou définit des informations de proxy pour la requête.
ReadWriteTimeout	Obtient ou définit un délai d’expiration en millisecondes lors de l’écriture dans ou de la lecture à partir d’un flux.
Referer	Obtient ou définit la valeur de l’en-tête Referer HTTP.
RequestUri	Obtient l’URI (Uniform Resource Identifier) d’origine de la requête.
SendChunked	Obtient ou définit une valeur qui indique s’il faut envoyer des données dans des segments à la ressource Internet.
ServerCertificateValidationCallback	Obtient ou définit une fonction de rappel pour valider le certificat de serveur.
ServicePoint	Obtient le point de service à utiliser pour la requête.
SupportsCookieContainer	Obtient une valeur qui indique si la demande fournit la prise en charge d’un CookieContainer.
Timeout	Obtient ou définit la valeur de délai d’attente en millisecondes pour les méthodes et GetRequestStream() les GetResponse() méthodes.
TransferEncoding	Obtient ou définit la valeur de l’en-tête Transfer-encoding HTTP.
UnsafeAuthenticatedConnectionSharing	Obtient ou définit une valeur qui indique s’il faut autoriser le partage de connexion authentifiée NTLM à haut débit.
UseDefaultCredentials	Obtient ou définit une Boolean valeur qui contrôle si les informations d’identification par défaut sont envoyées avec des requêtes.
UserAgent	Obtient ou définit la valeur de l’en-tête User-agent HTTP.

Méthodes

Nom	Description
Abort()	Annule une demande à une ressource Internet.
AddRange(Int32, Int32)	Ajoute un en-tête de plage d’octets à la demande d’une plage spécifiée.
AddRange(Int32)	Ajoute un en-tête de plage d’octets à une demande pour une plage spécifique à partir du début ou de la fin des données demandées.
AddRange(Int64, Int64)	Ajoute un en-tête de plage d’octets à la demande d’une plage spécifiée.
AddRange(Int64)	Ajoute un en-tête de plage d’octets à une demande pour une plage spécifique à partir du début ou de la fin des données demandées.
AddRange(String, Int32, Int32)	Ajoute un en-tête de plage à une demande pour une plage spécifiée.
AddRange(String, Int32)	Ajoute un en-tête Range à une demande d’une plage spécifique à partir du début ou de la fin des données demandées.
AddRange(String, Int64, Int64)	Ajoute un en-tête de plage à une demande pour une plage spécifiée.
AddRange(String, Int64)	Ajoute un en-tête Range à une demande d’une plage spécifique à partir du début ou de la fin des données demandées.
BeginGetRequestStream(AsyncCallback, Object)	Commence une demande asynchrone d’un Stream objet à utiliser pour écrire des données.
BeginGetResponse(AsyncCallback, Object)	Commence une requête asynchrone vers une ressource Internet.
EndGetRequestStream(IAsyncResult, TransportContext)	Met fin à une demande asynchrone d’un Stream objet à utiliser pour écrire des données et des sorties associées TransportContext au flux.
EndGetRequestStream(IAsyncResult)	Met fin à une demande asynchrone d’un Stream objet à utiliser pour écrire des données.
EndGetResponse(IAsyncResult)	Met fin à une requête asynchrone à une ressource Internet.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Obsolète. Remplit une SerializationInfo avec les données requises pour sérialiser l’objet cible.
GetRequestStream()	Obtient un Stream objet à utiliser pour écrire des données de requête.
GetRequestStream(TransportContext)	Obtient un Stream objet à utiliser pour écrire des données de requête et génère le TransportContext flux associé.
GetRequestStreamAsync()	En cas de substitution dans une classe descendante, retourne une Stream option permettant d’écrire des données dans la ressource Internet en tant qu’opération asynchrone. (Hérité de WebRequest)
GetResponse()	Retourne une réponse à partir d’une ressource Internet.
GetResponseAsync()	En cas de substitution dans une classe descendante, retourne une réponse à une requête Internet en tant qu’opération asynchrone. (Hérité de WebRequest)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

Nom	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Obsolète. Remplit les SerializationInfo données nécessaires pour sérialiser l’objet cible.

Voir aussi

• DefaultProxy, élément (Paramètres réseau)
• Modifications apportées à l’authentification NTLM pour HTTPWebRequest dans la version 3.5 SP1