Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

HttpWebRequest, classe

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

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

[SerializableAttribute]
public class HttpWebRequest : WebRequest, 
	ISerializable

Le type HttpWebRequest expose les membres suivants.

  NomDescription
Méthode publiqueHttpWebRequest() Obsolète. Initialise une nouvelle instance de la classe HttpWebRequest.
Méthode protégéeHttpWebRequest(SerializationInfo, StreamingContext) Obsolète. Initialise une nouvelle instance de la classe HttpWebRequest à partir des instances spécifiées des classes SerializationInfo et StreamingContext.
Début

  NomDescription
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAcceptObtient ou définit la valeur de l'en-tête HTTP Accept.
Propriété publiqueAddressObtient l'URI (Uniform Resource Identifier) de la ressource Internet qui répond réellement à la requête.
Propriété publiqueAllowAutoRedirectObtient ou définit une valeur qui indique si la demande doit suivre les réponses de redirection.
Propriété publiquePris en charge dans .NET pour les applications du Windows StoreAllowReadStreamBufferingObtient ou définit une valeur indiquant si les données reçues à partir de la ressource Internet doivent être mises en mémoire tampon.
Propriété publiqueAllowWriteStreamBufferingObtient ou définit une valeur indiquant si les données envoyées à la ressource Internet doivent être mises en mémoire tampon.
Propriété publiqueAuthenticationLevelObtient ou définit des valeurs indiquant les niveaux d'authentification et d'emprunt d'identité utilisés pour cette demande. (Hérité de WebRequest.)
Propriété publiqueAutomaticDecompressionObtient ou définit le type de décompression utilisé.
Propriété publiqueCachePolicyObtient ou définit la stratégie de cache de cette demande. (Hérité de WebRequest.)
Propriété publiqueClientCertificatesObtient ou définit la collection de certificats de sécurité qui sont associés à cette requête.
Propriété publiqueConnectionObtient ou définit la valeur de l'en-tête HTTP Connection.
Propriété publiqueConnectionGroupNameObtient ou définit le nom du groupe de connexions pour la demande. (Substitue WebRequest.ConnectionGroupName.)
Propriété publiqueContentLengthObtient ou définit l'en-tête HTTP Content-length. (Substitue WebRequest.ContentLength.)
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreContentTypeObtient ou définit la valeur de l'en-tête HTTP Content-type. (Substitue WebRequest.ContentType.)
Propriété publiqueContinueDelegateObtient 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.
Propriété publiquePris en charge dans .NET pour les applications du Windows StoreContinueTimeoutObtient ou définit le délai d'attente, en millisecondes, jusqu'à réception de la réponse 100-Continue depuis le serveur.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCookieContainerObtient ou définit les cookies associés à la requête.
Propriété publiqueCreatorInstance Obsolète. En cas de substitution dans une classe descendante, obtient l'objet de fabrique dérivé de la classe IWebRequestCreate utilisée afin de créer la WebRequest instanciée pour créer la requête à l'URI spécifié. (Hérité de WebRequest.)
Propriété publiquePris en charge dans .NET pour les applications du Windows StoreCredentialsObtient ou définit les informations d'authentification pour la requête. (Substitue WebRequest.Credentials.)
Propriété publiqueDateObtient ou définit la valeur d'en-tête HTTP Date à utiliser dans une requête HTTP.
Propriété publiqueMembre statiqueDefaultCachePolicyObtient ou définit la stratégie de cache par défaut de cette requête.
Propriété publiqueMembre statiqueDefaultMaximumErrorResponseLengthObtient ou définit la longueur maximale par défaut d'une réponse d'erreur HTTP.
Propriété publiqueMembre statiqueDefaultMaximumResponseHeadersLengthObtient ou définit la valeur par défaut de la propriété MaximumResponseHeadersLength.
Propriété publiqueExpectObtient ou définit la valeur de l'en-tête HTTP Expect.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreHaveResponseObtient une valeur indiquant si une réponse a été reçue d'une ressource Internet.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreHeadersSpécifie une collection de paires nom-valeur qui composent les en-têtes HTTP. (Substitue WebRequest.Headers.)
Propriété publiqueHostObtient 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.
Propriété publiqueIfModifiedSinceObtient ou définit la valeur de l'en-tête HTTP If-Modified-Since.
Propriété publiqueImpersonationLevelObtient ou définit le niveau d'emprunt d'identité pour la demande en cours. (Hérité de WebRequest.)
Propriété publiqueKeepAliveObtient ou définit une valeur indiquant si une connexion persistante doit être établie avec la ressource Internet.
Propriété publiqueMaximumAutomaticRedirectionsObtient ou définit le nombre maximal de redirections suivies par la requête.
Propriété publiqueMaximumResponseHeadersLengthObtient ou définit la longueur maximale autorisée des en-têtes de réponse.
Propriété publiqueMediaTypeObtient ou définit le type de média de la requête.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMethodObtient ou définit la méthode pour la requête. (Substitue WebRequest.Method.)
Propriété publiquePipelinedObtient ou définit une valeur indiquant si la requête doit être canalisée en rafale vers la ressource Internet.
Propriété publiquePreAuthenticateObtient ou définit une valeur indiquant si un en-tête d'autorisation doit être envoyé avec la requête. (Substitue WebRequest.PreAuthenticate.)
Propriété publiqueProtocolVersionObtient ou définit le nom du serveur proxy à utiliser pour les requêtes.
Propriété publiqueProxyObtient ou définit les informations de proxy pour la requête. (Substitue WebRequest.Proxy.)
Propriété publiqueReadWriteTimeoutObtient ou définit un délai d'expiration exprimé en millisecondes lors de la lecture ou de l'écriture d'un flux.
Propriété publiqueRefererObtient ou définit la valeur de l'en-tête HTTP Referer.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreRequestUriObtient l'URI (Uniform Resource Identifier) d'origine de la requête. (Substitue WebRequest.RequestUri.)
Propriété publiqueSendChunkedObtient ou définit une valeur indiquant si les données doivent être envoyées par segments à la ressource Internet.
Propriété publiqueServerCertificateValidationCallbackObtient ou définit une fonction de rappel pour valider le certificat de serveur.
Propriété publiqueServicePointObtient le point de service à utiliser pour la requête.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSupportsCookieContainerObtient une valeur qui indique si la requête fournit une prise en charge pour une CookieContainer.
Propriété publiqueTimeoutObtient ou définit la valeur du délai d'attente exprimé en millisecondes pour les méthodes GetResponse et GetRequestStream. (Substitue WebRequest.Timeout.)
Propriété publiqueTransferEncodingObtient ou définit la valeur de l'en-tête HTTP Transfer-encoding.
Propriété publiqueUnsafeAuthenticatedConnectionSharingObtient ou définit une valeur indiquant si le partage de connexion authentifié NTLM à haut débit est autorisé.
Propriété publiquePris en charge dans .NET pour les applications du Windows StoreUseDefaultCredentialsObtient ou définit une valeur Boolean qui contrôle si les informations d'identification par défaut sont envoyées avec les requêtes. (Substitue WebRequest.UseDefaultCredentials.)
Propriété publiqueUserAgentObtient ou définit la valeur de l'en-tête HTTP User-agent.
Début

  NomDescription
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAbortAnnule une requête adressée à une ressource Internet. (Substitue WebRequest.Abort().)
Méthode publiqueAddRange(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.
Méthode publiqueAddRange(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.
Méthode publiqueAddRange(Int32, Int32)Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée.
Méthode publiqueAddRange(Int64, Int64)Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée.
Méthode publiqueAddRange(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.
Méthode publiqueAddRange(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.
Méthode publiqueAddRange(String, Int32, Int32)Ajoute un en-tête de plage à une requête d'une plage spécifiée.
Méthode publiqueAddRange(String, Int64, Int64)Ajoute un en-tête de plage à une requête d'une plage spécifiée.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreBeginGetRequestStreamDémarre une requête asynchrone d'un objet Stream à utiliser pour écrire des données. (Substitue WebRequest.BeginGetRequestStream(AsyncCallback, Object).)
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreBeginGetResponseDémarre une requête asynchrone adressée à une ressource Internet. (Substitue WebRequest.BeginGetResponse(AsyncCallback, Object).)
Méthode publiqueCreateObjRefCrée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject.)
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEndGetRequestStream(IAsyncResult)Met fin à une requête asynchrone d'un objet Stream à utiliser pour écrire des données. (Substitue WebRequest.EndGetRequestStream(IAsyncResult).)
Méthode publiqueEndGetRequestStream(IAsyncResult, TransportContext)Termine une requête asynchrone pour un objet Stream à utiliser pour écrire les données et exporte le TransportContext associé avec le flux de données.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEndGetResponseTermine une requête asynchrone adressée à une ressource Internet. (Substitue WebRequest.EndGetResponse(IAsyncResult).)
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFinalize 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.)
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetLifetimeServiceRé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.)
Méthode protégéeGetObjectDataInfrastructure. Remplit SerializationInfo avec les données nécessaires pour sérialiser l'objet cible. (Substitue WebRequest.GetObjectData(SerializationInfo, StreamingContext).)
Méthode publiqueGetRequestStream()Obtient un objet Stream à utiliser pour écrire les données de la requête. (Substitue WebRequest.GetRequestStream().)
Méthode publiqueGetRequestStream(TransportContext)Obtient un objet Stream à utiliser pour écrire les données de la requête et exporte le TransportContext associé avec le flux de données.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreGetRequestStreamAsyncEn cas de substitution dans une classe descendante, retourne un Stream pour l'écriture de données vers la ressource Internet en tant qu'opération asynchrone. (Hérité de WebRequest.)
Méthode publiqueGetResponseRetourne une réponse d'une ressource Internet. (Substitue WebRequest.GetResponse().)
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreGetResponseAsyncEn cas de substitution dans une classe descendante, retourne une réponse à une demande Internet en tant qu'opération asynchrone. (Hérité de WebRequest.)
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueInitializeLifetimeServiceObtient 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.)
Méthode protégéePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMemberwiseClone()Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeMemberwiseClone(Boolean)Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject.)
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeISerializable.GetObjectDataInfrastructure. Remplit SerializationInfo avec les données nécessaires pour sérialiser l'objet cible.
Début

La classe HttpWebRequest fournit la prise en charge des propriétés et méthodes définies dans WebRequest, ainsi que des propriétés et méthodes supplémentaires permettant à l'utilisateur d'interagir directement avec les serveurs à l'aide de HTTP.

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

La méthode GetResponse lance une requête synchrone à la ressource spécifiée dans la propriété RequestUri et retourne un HttpWebResponse contenant la réponse. Vous pouvez lancer une requête asynchrone de la ressource à l'aide des méthodes BeginGetResponse et EndGetResponse.

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

Pour l'authentification d'un client à l'aide de HttpWebRequest, le certificat client doit être installé dans le répertoire Magasin de certificats My de l'utilisateur en cours.

La classe HttpWebRequest lève WebException lorsque des erreurs se produisent pendant l'accès à une ressource. La propriété WebException.Status contient une valeur WebExceptionStatus qui indique la source de l'erreur. Si WebException.Status est WebExceptionStatus.ProtocolError, la propriété Response 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 la liste complète de ces en-têtes. Vous pouvez définir d'autres en-têtes dans la propriété Headers sous la forme de 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 énumère les en-têtes HTTP définis par des propriétés, par des méthodes ou par le système.

Header

Défini par

Accept

Défini par la propriété Accept.

Connexion

Défini par la propriété Connection ou par la propriété KeepAlive.

Content-Length

Défini par la propriété ContentLength.

Content-Type

Défini par la propriété ContentType.

Expect

Défini par la propriété Expect.

Date

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

Hôte

Défini par le système pour indiquer les informations actuelles sur l'hôte.

If-Modified-Since

Défini par la propriété IfModifiedSince.

Plage

Défini par la méthode AddRange.

Referer

Défini par la propriété Referer.

Transfer-Encoding

Défini par la propriété TransferEncoding (la propriété SendChunked doit avoir la valeur true).

User-Agent

Défini par la propriété UserAgent.

RemarqueRemarque

HttpWebRequest est inscrit automatiquement. Il est inutile d'appeler la méthode RegisterPrefix pour inscrire System.Net.HttpWebRequest avant d'utiliser des URI commençant par http:// ou https://.

L'ordinateur local ou le fichier de configuration d'application peut spécifier l'utilisation d'un proxy par défaut. Si vous spécifiez la propriété Proxy, les paramètres proxy de la propriété Proxy remplacent alors l'ordinateur local ou le fichier de configuration d'application et l'instance HttpWebRequest utilise les paramètres proxy spécifiés. Si aucun proxy n'est spécifié dans un fichier de configuration et la propriété Proxy ne l'est pas non plus, la classe HttpWebRequest choisit les paramètres proxy hérités de Microsoft Internet Explorer sur l'ordinateur local. Si aucun paramètre proxy n'est disponible dans Internet Explorer, la demande est transmise directement au serveur.

La classe HttpWebRequest 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 lorsque la liste de contournement est analysée directement par Internet Explorer. Par exemple, la classe HttpWebRequest analysera une liste de contournement de "nt*" dans Internet Explorer en tant qu'expression régulière de "nt.$". Ce comportement diffère du comportement natif observé dans Internet Explorer. Ainsi, une URL de type http://intxxxxx contournerait le proxy avec la classe HttpWebRequest mais pas avec Internet Explorer.

RemarqueRemarque

Le Framework met les sessions SSL en cache au fur et à mesure de leur création et tente, dans la mesure du possible, de réutiliser une session mise en cache pour une nouvelle requête. 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.

RemarqueRemarque

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

L'exemple de code suivant crée HttpWebRequest pour l'URI http://www.contoso.com/.



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



.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

  • WebPermission 

    pour accéder à l'URI demandé ou à tout URI vers lequel la demande est redirigée. Énumération associée : Connect

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft