HttpWebRequest Classe
TOC
Réduire la table des matières
Développer la table des matières
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

 

Publication: juillet 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 produit et n'est pas destinée à être utilisée directement à partir de 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 produit et n'est pas destinée à être utilisée directement à partir de votre code. Remplit SerializationInfo avec les données nécessaires pour sérialiser l'objet cible.

La HttpWebRequest classe prend en charge les propriétés et méthodes définies dans WebRequest et d'autres propriétés et méthodes qui permettent aux utilisateurs d'interagir directement avec les 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 pour l'identificateur de ressource uniforme (URI) est http:// ou https://, Create renvoie un HttpWebRequest objet.

Le GetResponse méthode effectue une demande synchrone à la ressource spécifiée dans le RequestUri propriété et retourne un HttpWebResponse qui contient la réponse. Vous pouvez lancer une demande asynchrone pour la ressource à l'aide du BeginGetResponse et EndGetResponse méthodes.

Lorsque vous souhaitez envoyer des données à la ressource, le GetRequestStream méthode renvoie un Stream objet à utiliser pour envoyer des données. Le BeginGetRequestStream et EndGetRequestStream méthodes 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 personnel de l'utilisateur actuel.

La HttpWebRequest classe lève un WebException lorsque des erreurs se produisent pendant l'accès à une ressource. Le WebException.Status propriété contient un WebExceptionStatus valeur qui indique la source de l'erreur. Lorsque WebException.Status est WebExceptionStatus.ProtocolError, le Response propriété contient le HttpWebResponse reçu de la ressource.

HttpWebRequest expose des valeurs d'en-tête HTTP courantes envoyées à la ressource Internet en tant que propriétés, définies par des méthodes ou par le système. le tableau suivant contient une liste complète. Vous pouvez définir d'autres en-têtes le 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 requête.

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

En-tête

Définie par

Accepter

Définie par le Accept propriété.

Connexion

Définie par le Connection propriété, KeepAlive propriété.

Content-Length

Définie par le ContentLength propriété.

Type de contenu

Définie par le ContentType propriété.

Attendre

Définie par le Expect propriété.

Date

Défini par le système à la date actuelle.

Host

Défini par le système pour des informations sur l'hôte actuel.

If-Modified-Since

Définie par le IfModifiedSince propriété.

Plage

Définie par le AddRange (méthode).

Références

Définie par le Referer propriété.

Codage de transfert

Définie par le TransferEncoding propriété (le SendChunked propriété doit être true).

User-Agent

Définie par le UserAgent propriété.

System_CAPS_noteRemarque

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

L'ordinateur local ou un fichier de configuration d'application peut spécifier qu'un proxy par défaut est utilisé. Si le Proxy propriété est spécifiée, puis les paramètres de proxy de le Proxy l'ordinateur local ou un fichier de configuration d'application de substitution de propriété et la HttpWebRequest instance utilisera les paramètres de proxy spécifiés. Si aucun proxy n'est spécifié dans un fichier de configuration et le Proxy propriété n'est pas spécifiée, la HttpWebRequest classe utilise les paramètres proxy hérités à partir d'Internet Explorer sur l'ordinateur local. S'il n'y a aucun paramètre de proxy dans Internet Explorer, la demande est envoyée directement au serveur.

La HttpWebRequest classe analyse une liste de contournement proxy avec des caractères génériques hérités d'Internet Explorer de manière différente que la liste de contournement est analysée directement par Internet Explorer. Par exemple, la HttpWebRequest classe analysera une liste de contournement de « nt * » à partir d'Internet Explorer comme une expression régulière de "nt. $». Cela diffère du comportement natif d'Internet Explorer. Par conséquent, une URL de «http://intxxxxx» le proxy à l'aide de la HttpWebRequest classe, mais pas avec Internet Explorer.

System_CAPS_noteRemarque

Le Framework met en cache les sessions SSL lors de leur création et tente de réutiliser une session mise en cache pour une nouvelle demande, si possible. Lorsque vous tentez de réutiliser une session SSL, le Framework utilise le premier élément de ClientCertificates (s'il en existe un), ou essaie de réutiliser une session anonyme si ClientCertificates est vide.

System_CAPS_noteRemarque

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.

Le .NET Framework 4.6 inclut une nouvelle fonctionnalité de sécurité qui bloque le chiffrement non sécurisé et pour les connexions, les algorithmes de hachage. Applications à l'aide de TLS/SSL via des API telles que HttpClient, HttpWebRequest, FTPClient, SmtpClient, SslStream, etc. et ciblant .NET Framework 4.6 Obtient le comportement plus sécurisés par défaut.

Les développeurs peuvent voulez désactiver ce comportement afin de conserver l'interopérabilité avec leurs services existants SSL3 TLS ou avec les services de RC4. This article Explique comment modifier votre code afin que le nouveau comportement est désactivé.

L'exemple de code suivant crée un HttpWebRequest pour l'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

Universal Windows Platform
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Portable Class Library
Pris en charge dans : portable .NET platforms
Silverlight
Disponible depuis 2.0
Windows Phone Silverlight
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début
Afficher:
© 2016 Microsoft