Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

HttpWebRequest classe

 

Date de publication : novembre 2016

Fournit une implémentation propre à HTTP de la classe WebRequest.

Espace de noms:   System.Net
Assembly:  System (dans System.dll)

System.Object
  System.MarshalByRefObject
    System.Net.WebRequest
      System.Net.HttpWebRequest

[SerializableAttribute]
public class HttpWebRequest : WebRequest, ISerializable

NomDescription
System_CAPS_pubmethodHttpWebRequest()

Obsolète.Initialise une nouvelle instance de la classe HttpWebRequest.

System_CAPS_protmethodHttpWebRequest(SerializationInfo, StreamingContext)

Obsolète.Initialise une nouvelle instance de la classe HttpWebRequest à partir des instances spécifiées des classes SerializationInfo et StreamingContext.

NomDescription
System_CAPS_pubpropertyAccept

Obtient ou définit la valeur de l’en-tête HTTP Accept.

System_CAPS_pubpropertyAddress

Obtient l'URI (Uniform Resource Identifier) de la ressource Internet qui répond réellement à la requête.

System_CAPS_pubpropertyAllowAutoRedirect

Obtient ou définit une valeur qui indique si la requête doit suivre les réponses de redirection.

System_CAPS_pubpropertyAllowReadStreamBuffering

Obtient ou définit une valeur indiquant si les données reçues à partir de la ressource Internet doivent être mises en mémoire tampon.

System_CAPS_pubpropertyAllowWriteStreamBuffering

Obtient ou définit une valeur indiquant si les données envoyées à la ressource Internet doivent être mises en mémoire tampon.

System_CAPS_pubpropertyAuthenticationLevel

Obtient ou définit des valeurs indiquant les niveaux d'authentification et d'emprunt d'identité utilisés pour cette demande.(Hérité de WebRequest.)

System_CAPS_pubpropertyAutomaticDecompression

Obtient ou définit le type de décompression utilisé.

System_CAPS_pubpropertyCachePolicy

Obtient ou définit la stratégie de cache de cette demande.(Hérité de WebRequest.)

System_CAPS_pubpropertyClientCertificates

Obtient ou définit la collection de certificats de sécurité qui sont associés à cette requête.

System_CAPS_pubpropertyConnection

Obtient ou définit la valeur de l’en-tête HTTP Connection.

System_CAPS_pubpropertyConnectionGroupName

Obtient ou définit le nom du groupe de connexions pour la requête.(Remplace WebRequest.ConnectionGroupName.)

System_CAPS_pubpropertyContentLength

Obtient ou définit l’en-tête HTTP Content-length.(Remplace WebRequest.ContentLength.)

System_CAPS_pubpropertyContentType

Obtient ou définit la valeur de l’en-tête HTTP Content-type.(Remplace WebRequest.ContentType.)

System_CAPS_pubpropertyContinueDelegate

Obtient ou définit la méthode du délégué qui est appelée lors de la réception d'une réponse HTTP 100-Continue de la ressource Internet.

System_CAPS_pubpropertyContinueTimeout

Obtient ou définit un délai d’attente, en millisecondes, jusqu’à réception de la réponse 100-Continue depuis le serveur.

System_CAPS_pubpropertyCookieContainer

Obtient ou définit les cookies associés à la requête.

System_CAPS_pubpropertyCreatorInstance

Obsolète.En cas de remplacement dans une classe descendante, obtient l'objet de fabrique dérivé de la classe IWebRequestCreate utilisé pour créer l'élément WebRequest instancié pour créer la demande à l'URI spécifié.(Hérité de WebRequest.)

System_CAPS_pubpropertyCredentials

Obtient ou définit les informations d'authentification pour la requête.(Remplace WebRequest.Credentials.)

System_CAPS_pubpropertyDate

Obtient ou définit la valeur d’en-tête HTTP Date à utiliser dans une requête HTTP.

System_CAPS_pubpropertySystem_CAPS_staticDefaultCachePolicy

Obtient ou définit la stratégie de cache par défaut de cette requête.

System_CAPS_pubpropertySystem_CAPS_staticDefaultMaximumErrorResponseLength

Obtient ou définit la longueur maximale par défaut d'une réponse d'erreur HTTP.

System_CAPS_pubpropertySystem_CAPS_staticDefaultMaximumResponseHeadersLength

Obtient ou définit la valeur par défaut de la propriété MaximumResponseHeadersLength.

System_CAPS_pubpropertyExpect

Obtient ou définit la valeur de l’en-tête HTTP Expect.

System_CAPS_pubpropertyHaveResponse

Obtient une valeur indiquant si une réponse a été reçue d'une ressource Internet.

System_CAPS_pubpropertyHeaders

Spécifie une collection de paires nom-valeur qui composent les en-têtes HTTP.(Remplace WebRequest.Headers.)

System_CAPS_pubpropertyHost

Obtient ou définit la valeur d'en-tête Hôte à utiliser dans une requête HTTP indépendante de l'URI de la requête.

System_CAPS_pubpropertyIfModifiedSince

Obtient ou définit la valeur de l’en-tête HTTP If-Modified-Since.

System_CAPS_pubpropertyImpersonationLevel

Obtient ou définit le niveau d'emprunt d'identité pour la demande en cours.(Hérité de WebRequest.)

System_CAPS_pubpropertyKeepAlive

Obtient ou définit une valeur indiquant si une connexion persistante doit être établie avec la ressource Internet.

System_CAPS_pubpropertyMaximumAutomaticRedirections

Obtient ou définit le nombre maximal de redirections suivies par la requête.

System_CAPS_pubpropertyMaximumResponseHeadersLength

Obtient ou définit la longueur maximale autorisée des en-têtes de réponse.

System_CAPS_pubpropertyMediaType

Obtient ou définit le type de média de la requête.

System_CAPS_pubpropertyMethod

Obtient ou définit la méthode pour la requête.(Remplace WebRequest.Method.)

System_CAPS_pubpropertyPipelined

Obtient ou définit une valeur indiquant si la requête doit être canalisée en rafale vers la ressource Internet.

System_CAPS_pubpropertyPreAuthenticate

Obtient ou définit une valeur indiquant si un en-tête d'autorisation doit être envoyé avec la requête.(Remplace WebRequest.PreAuthenticate.)

System_CAPS_pubpropertyProtocolVersion

Obtient ou définit le nom du serveur proxy à utiliser pour les requêtes.

System_CAPS_pubpropertyProxy

Obtient ou définit les informations de proxy pour la requête.(Remplace WebRequest.Proxy.)

System_CAPS_pubpropertyReadWriteTimeout

Obtient ou définit un délai d'expiration exprimé en millisecondes lors de la lecture ou de l'écriture d'un flux.

System_CAPS_pubpropertyReferer

Obtient ou définit la valeur de l’en-tête HTTP Referer.

System_CAPS_pubpropertyRequestUri

Obtient l'URI (Uniform Resource Identifier) d'origine de la requête.(Remplace WebRequest.RequestUri.)

System_CAPS_pubpropertySendChunked

Obtient ou définit une valeur indiquant si les données doivent être envoyées par segments à la ressource Internet.

System_CAPS_pubpropertyServerCertificateValidationCallback

Obtient ou définit une fonction de rappel pour valider le certificat de serveur.

System_CAPS_pubpropertyServicePoint

Obtient le point de service à utiliser pour la requête.

System_CAPS_pubpropertySupportsCookieContainer

Obtient une valeur qui indique si la requête fournit une prise en charge pour un CookieContainer.

System_CAPS_pubpropertyTimeout

Obtient ou définit la valeur du délai d’attente exprimée en millisecondes pour les méthodes GetResponse et GetRequestStream.(Remplace WebRequest.Timeout.)

System_CAPS_pubpropertyTransferEncoding

Obtient ou définit la valeur de l’en-tête HTTP Transfer-encoding.

System_CAPS_pubpropertyUnsafeAuthenticatedConnectionSharing

Obtient ou définit une valeur indiquant si le partage de connexion authentifié NTLM à haut débit est autorisé.

System_CAPS_pubpropertyUseDefaultCredentials

Obtient ou définit une valeur Boolean qui contrôle si les informations d’identification par défaut sont envoyées avec les requêtes.(Remplace WebRequest.UseDefaultCredentials.)

System_CAPS_pubpropertyUserAgent

Obtient ou définit la valeur de l’en-tête HTTP User-agent.

NomDescription
System_CAPS_pubmethodAbort()

Annule une requête adressée à une ressource Internet.(Remplace WebRequest.Abort().)

System_CAPS_pubmethodAddRange(Int32)

Ajoute un en-tête de plage d'octets à une requête d'une plage spécifique à partir du début ou de la fin des données demandées.

System_CAPS_pubmethodAddRange(Int32, Int32)

Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée.

System_CAPS_pubmethodAddRange(Int64)

Ajoute un en-tête de plage d'octets à une requête d'une plage spécifique à partir du début ou de la fin des données demandées.

System_CAPS_pubmethodAddRange(Int64, Int64)

Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée.

System_CAPS_pubmethodAddRange(String, Int32)

Ajoute un en-tête de plage à une requête pour une plage spécifique à partir du début ou de la fin des données demandées.

System_CAPS_pubmethodAddRange(String, Int32, Int32)

Ajoute un en-tête de plage à une requête d'une plage spécifiée.

System_CAPS_pubmethodAddRange(String, Int64)

Ajoute un en-tête de plage à une requête pour une plage spécifique à partir du début ou de la fin des données demandées.

System_CAPS_pubmethodAddRange(String, Int64, Int64)

Ajoute un en-tête de plage à une requête d'une plage spécifiée.

System_CAPS_pubmethodBeginGetRequestStream(AsyncCallback, Object)

Démarre une requête asynchrone pour un objet Stream à utiliser pour écrire des données.(Remplace WebRequest.BeginGetRequestStream(AsyncCallback, Object).)

System_CAPS_pubmethodBeginGetResponse(AsyncCallback, Object)

Démarre une requête asynchrone adressée à une ressource Internet.(Remplace WebRequest.BeginGetResponse(AsyncCallback, Object).)

System_CAPS_pubmethodCreateObjRef(Type)

Crée un objet qui contient toutes les informations requises pour générer un proxy permettant de communiquer avec un objet distant.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodEndGetRequestStream(IAsyncResult)

Termine une requête asynchrone pour qu’un objet Stream à utiliser écrive des données.(Remplace WebRequest.EndGetRequestStream(IAsyncResult).)

System_CAPS_pubmethodEndGetRequestStream(IAsyncResult, TransportContext)

Termine une requête asynchrone pour un objet Stream à utiliser pour écrire les données et crée une sortie du TransportContext associé au flux.

System_CAPS_pubmethodEndGetResponse(IAsyncResult)

Termine une requête asynchrone adressée à une ressource Internet.(Remplace WebRequest.EndGetResponse(IAsyncResult).)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetLifetimeService()

Récupère l’objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.(Hérité de MarshalByRefObject.)

System_CAPS_protmethodGetObjectData(SerializationInfo, StreamingContext)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Remplit un SerializationInfo avec les données nécessaires pour sérialiser l'objet cible.(Remplace WebRequest.GetObjectData(SerializationInfo, StreamingContext).)

System_CAPS_pubmethodGetRequestStream()

Obtient un objet Stream à utiliser pour écrire les données de la requête.(Remplace WebRequest.GetRequestStream().)

System_CAPS_pubmethodGetRequestStream(TransportContext)

Obtient un objet Stream à utiliser pour écrire les données de la requête et exporte le TransportContext associé au flux.

System_CAPS_pubmethodGetRequestStreamAsync()

En cas de remplacement dans une classe descendante, retourne un élément Stream pour l'écriture de données dans la ressource Internet sous forme d'opération asynchrone.(Hérité de WebRequest.)

System_CAPS_pubmethodGetResponse()

Retourne une réponse d'une ressource Internet.(Remplace WebRequest.GetResponse().)

System_CAPS_pubmethodGetResponseAsync()

En cas de substitution dans une classe descendante, retourne une réponse à une demande Internet en tant qu'opération asynchrone.(Hérité de WebRequest.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

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.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crée une copie superficielle de l’utilisateur actuel MarshalByRefObject objet.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodISerializable.GetObjectData(SerializationInfo, StreamingContext)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Remplit SerializationInfo avec les données nécessaires pour sérialiser l'objet cible.

The T:System.Net.HttpWebRequest class provides support for the properties and methods defined in T:System.Net.WebRequest and for additional properties and methods that enable the user to interact directly with servers using HTTP.

Do not use the M:System.Net.HttpWebRequest.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext) constructor. Use the Overload:System.Net.WebRequest.Create method to initialize new T:System.Net.HttpWebRequest objects. If the scheme for the Uniform Resource Identifier (URI) is http:// or https://, Overload:System.Net.WebRequest.Create returns an T:System.Net.HttpWebRequest object.

The M:System.Net.HttpWebRequest.GetResponse method makes a synchronous request to the resource specified in the P:System.Net.HttpWebRequest.RequestUri property and returns an T:System.Net.HttpWebResponse that contains the response object. The response data can be received by using the stream returned by M:System.Net.HttpWebResponse.GetResponseStream. If the response object or the response stream is closed, remaining data will be forfeited. The remaining data will be drained and the socket will be re-used for subsequent requests when closing the response object or stream if the following conditions hold: it's a keep-alive or pipelined request, only a small amount of data needs to be received, or the remaining data is received in a small time interval. If none of the mentioned conditions hold or the drain time is exceeded, the socket will be closed. For keep-alive or pipelined connections, we strongly recommend that the application reads the streams until EOF. This ensures that the socket will be re-used for subsequent requests resulting in better performance and less resources used.

When you want to send data to the resource, the M:System.Net.HttpWebRequest.GetRequestStream method returns a T:System.IO.Stream object to use to send data. The M:System.Net.HttpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object) and M:System.Net.HttpWebRequest.EndGetRequestStream(System.IAsyncResult) methods provide asynchronous access to the send data stream.

For client authentication with T:System.Net.HttpWebRequest, the client certificate must be installed in the My certificate store of the current user.

The T:System.Net.HttpWebRequest class throws a T:System.Net.WebException when errors occur while accessing a resource. The P:System.Net.WebException.Status property contains a T:System.Net.WebExceptionStatus value that indicates the source of the error. When P:System.Net.WebException.Status is F:System.Net.WebExceptionStatus.ProtocolError, the P:System.Net.WebException.Response property contains the T:System.Net.HttpWebResponse received from the resource.

HttpWebRequest exposes common HTTP header values sent to the Internet resource as properties, set by methods, or set by the system; the following table contains a complete list. You can set other headers in the Headers property as name/value pairs. Note that servers and caches may change or add headers during the request.

The following table lists the HTTP headers that are set either by properties or methods or the system.

Header

Set by

Accept

Set by the P:System.Net.HttpWebRequest.Accept property.

Connection

Set by the P:System.Net.HttpWebRequest.Connection property, P:System.Net.HttpWebRequest.KeepAlive property.

Content-Length

Set by the P:System.Net.HttpWebRequest.ContentLength property.

Content-Type

Set by the P:System.Net.HttpWebRequest.ContentType property.

Expect

Set by the P:System.Net.HttpWebRequest.Expect property.

Date

Set by the system to current date.

Host

Set by the system to current host information.

If-Modified-Since

Set by the P:System.Net.HttpWebRequest.IfModifiedSince property.

Range

Set by the M:System.Net.HttpWebRequest.AddRange(System.Int32,System.Int32) method.

Referer

Set by the P:System.Net.HttpWebRequest.Referer property.

Transfer-Encoding

Set by the P:System.Net.HttpWebRequest.TransferEncoding property (the P:System.Net.HttpWebRequest.SendChunked property must be true).

User-Agent

Set by the P:System.Net.HttpWebRequest.UserAgent property.

System_CAPS_noteRemarque

HttpWebRequest is registered automatically. You do not need to call the RegisterPrefix method to register System.Net.HttpWebRequest before using URIs beginning with http:// or https://.

The local computer or application config file may specify that a default proxy be used. If the P:System.Net.HttpWebRequest.Proxy property is specified, then the proxy settings from the P:System.Net.HttpWebRequest.Proxy property override the local computer or application config file and the T:System.Net.HttpWebRequest instance will use the proxy settings specified. If no proxy is specified in a config file and the P:System.Net.HttpWebRequest.Proxy property is unspecified, the T:System.Net.HttpWebRequest class uses the proxy settings inherited from Internet Explorer on the local computer. If there are no proxy settings in Internet Explorer, the request is sent directly to the server.

The T:System.Net.HttpWebRequest class parses a proxy bypass list with wildcard characters inherited from Internet Explorer differently than the bypass list is parsed directly by Internet Explorer. For example, the T:System.Net.HttpWebRequest class will parse a bypass list of "nt*" from Internet Explorer as a regular expression of "nt.$". This differs from the native behavior of Internet Explorer. So a URL of "http://intxxxxx" would bypass the proxy using the T:System.Net.HttpWebRequest class, but would not bypass the proxy using Internet Explorer.

System_CAPS_noteRemarque

The Framework caches SSL sessions as they are created and attempts to reuse a cached session for a new request, if possible. When attempting to reuse an SSL session, the Framework uses the first element of P:System.Net.HttpWebRequest.ClientCertificates (if there is one), or tries to reuse an anonymous sessions if P:System.Net.HttpWebRequest.ClientCertificates is empty.

System_CAPS_noteRemarque

For security reasons, cookies are disabled by default. If you want to use cookies, use the P:System.Net.HttpWebRequest.CookieContainer property to enable cookies.

The .NET Framework 4.6 includes a new security feature that blocks insecure cipher and hashing algorithms for connections. Applications using TLS/SSL through APIs such as HttpClient, HttpWebRequest, FTPClient, SmtpClient, SslStream, etc. and targeting .NET Framework 4.6 get the more-secure behavior by default.

Developers may want to opt out of this behavior in order to maintain interoperability with their existing SSL3 services OR TLS w/ RC4 services. This articlehttps://support.microsoft.com/kb/3069494 explains how to modify your code so that the new behavior is disabled.

The following code example creates an T:System.Net.HttpWebRequest for the URI http://www.contoso.com/.


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

WebPermission

to access the requested URI or any URI that the request is redirected to. Associated enumeration: F:System.Net.NetworkAccess.Connect

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: