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

0 sur 2 ont trouvé cela utile - Évaluez ce sujet

HttpWebRequest, classe

.NET Framework 4.5

Autres versions

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

Hiérarchie d'héritage

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

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

Syntaxe

C++

[SerializableAttribute]
public class HttpWebRequest : WebRequest, 
	ISerializable

Le type HttpWebRequest expose les membres suivants.

Constructeurs

	Nom	Description
	HttpWebRequest()	Obsolète. Initialise une nouvelle instance de la classe HttpWebRequest.
	HttpWebRequest(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

Propriétés

	Nom	Description
	Accept	Obtient ou définit la valeur de l'en-tête HTTP Accept.
	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 requête doit suivre les réponses de redirection.
	AllowReadStreamBuffering	Obtient ou définit une valeur qui indique si la mise en mémoire tampon du reçu de la ressource Internet.
	AllowWriteStreamBuffering	Obtient ou définit une valeur indiquant si les données envoyées à la ressource Internet doivent être mises en mémoire tampon.
	AuthenticationLevel	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.)
	AutomaticDecompression	Obtient ou définit le type de décompression utilisé.
	CachePolicy	Obtient ou définit la stratégie de cache de cette demande. (Hérité de WebRequest.)
	ClientCertificates	Obtient ou définit la collection de certificats de sécurité qui sont associés à cette requête.
	Connection	Obtient ou définit la valeur de l'en-tête HTTP Connection.
	ConnectionGroupName	Obtient ou définit le nom du groupe de connexions pour la demande. (Substitue WebRequest.ConnectionGroupName.)
	ContentLength	Obtient ou définit l'en-tête HTTP Content-length. (Substitue WebRequest.ContentLength.)
	ContentType	Obtient ou définit la valeur de l'en-tête HTTP Content-type. (Substitue WebRequest.ContentType.)
	ContinueDelegate	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.
	ContinueTimeout	Obtient ou définit un délai d'attente, en secondes, pour attendre l'état du serveur après 100 continuent soient reçus.
	CookieContainer	Obtient ou définit les cookies associés à la requête.
	CreatorInstance	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.)
	Credentials	Obtient ou définit les informations d'authentification pour la requête. (Substitue WebRequest.Credentials.)
	Date	Obtient ou définit la valeur d'en-tête HTTP Date à utiliser dans une requête HTTP.
	DefaultCachePolicy	Obtient ou définit la stratégie de cache par défaut de 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 propriété MaximumResponseHeadersLength.
	Expect	Obtient ou définit la valeur de l'en-tête HTTP Expect.
	HaveResponse	Obtient une valeur indiquant si une réponse a été reçue d'une ressource Internet.
	Headers	Spécifie une collection de paires nom-valeur qui composent les en-têtes HTTP. (Substitue WebRequest.Headers.)
	Host	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.
	IfModifiedSince	Obtient ou définit la valeur de l'en-tête HTTP If-Modified-Since.
	ImpersonationLevel	Obtient ou définit le niveau d'emprunt d'identité pour la demande en cours. (Hérité de WebRequest.)
	KeepAlive	Obtient ou définit une valeur indiquant si une connexion persistante doit être établie avec la ressource Internet.
	MaximumAutomaticRedirections	Obtient ou définit le nombre maximal de redirections suivies par la requête.
	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 pour la requête. (Substitue WebRequest.Method.)
	Pipelined	Obtient ou définit une valeur indiquant si la requête doit être canalisée en rafale vers la ressource Internet.
	PreAuthenticate	Obtient ou définit une valeur indiquant si un en-tête d'autorisation doit être envoyé avec la requête. (Substitue WebRequest.PreAuthenticate.)
	ProtocolVersion	Obtient ou définit le nom du serveur proxy à utiliser pour les requêtes.
	Proxy	Obtient ou définit les informations de proxy pour la requête. (Substitue WebRequest.Proxy.)
	ReadWriteTimeout	Obtient ou définit un délai d'expiration exprimé en millisecondes lors de la lecture ou de l'écriture d'un flux.
	Referer	Obtient ou définit la valeur de l'en-tête HTTP Referer.
	RequestUri	Obtient l'URI (Uniform Resource Identifier) d'origine de la requête. (Substitue WebRequest.RequestUri.)
	SendChunked	Obtient ou définit une valeur indiquant si les données doivent être envoyées par segments à la ressource Internet.
	ServerCertificateValidationCallback	Obtient ou définit une fonction de rappel de validation du 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 de CookieContainer.
	Timeout	Obtient ou définit la valeur du délai d'attente exprimé en millisecondes pour les méthodes GetResponse et GetRequestStream. (Substitue WebRequest.Timeout.)
	TransferEncoding	Obtient ou définit la valeur de l'en-tête HTTP Transfer-encoding.
	UnsafeAuthenticatedConnectionSharing	Obtient ou définit une valeur indiquant si le partage de connexion authentifié NTLM à haut débit est autorisé.
	UseDefaultCredentials	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. (Substitue WebRequest.UseDefaultCredentials.)
	UserAgent	Obtient ou définit la valeur de l'en-tête HTTP User-agent.

Début

Méthodes

	Nom	Description
	Abort	Annule une requête adressée à une ressource Internet. (Substitue WebRequest.Abort().)
	AddRange(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.
	AddRange(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.
	AddRange(Int32, Int32)	Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée.
	AddRange(Int64, Int64)	Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée.
	AddRange(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.
	AddRange(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.
	AddRange(String, Int32, Int32)	Ajoute un en-tête de plage à une requête d'une plage spécifiée.
	AddRange(String, Int64, Int64)	Ajoute un en-tête de plage à une requête d'une plage spécifiée.
	BeginGetRequestStream	Démarre une requête asynchrone d'un objet Stream à utiliser pour écrire des données. (Substitue WebRequest.BeginGetRequestStream(AsyncCallback, Object).)
	BeginGetResponse	Démarre une requête asynchrone adressée à une ressource Internet. (Substitue WebRequest.BeginGetResponse(AsyncCallback, Object).)
	CreateObjRef	Cré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.)
	EndGetRequestStream(IAsyncResult)	Met fin à une requête asynchrone d'un objet Stream à utiliser pour écrire des données. (Substitue WebRequest.EndGetRequestStream(IAsyncResult).)
	EndGetRequestStream(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.
	EndGetResponse	Termine une requête asynchrone adressée à une ressource Internet. (Substitue WebRequest.EndGetResponse(IAsyncResult).)
	Equals(Object)	Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
	Finalize	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.)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetLifetimeService	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.)
	GetObjectData	Infrastructure. Remplit SerializationInfo avec les données nécessaires pour sérialiser l'objet cible. (Substitue WebRequest.GetObjectData(SerializationInfo, StreamingContext).)
	GetRequestStream()	Obtient un objet Stream à utiliser pour écrire les données de la requête. (Substitue WebRequest.GetRequestStream().)
	GetRequestStream(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.
	GetRequestStreamAsync	Une fois substituée dans une classe descendante, retourne Stream pour écrire des données à la ressource Internet en tant qu'opération asynchrone. (Hérité de WebRequest.)
	GetResponse	Retourne une réponse d'une ressource Internet. (Substitue WebRequest.GetResponse().)
	GetResponseAsync	Une fois substituée dans une classe descendante, retourne une réponse à une demande Internet en tant qu'opération asynchrone. (Hérité de WebRequest.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	InitializeLifetimeService	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 de l'objet Object actuel. (Hérité de Object.)
	MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Implémentations d'interface explicite

	Nom	Description
	ISerializable.GetObjectData	Infrastructure. Remplit SerializationInfo avec les données nécessaires pour sérialiser l'objet cible.

Début

Notes

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.

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

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

Remarque

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.

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

Exemples

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

C++



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

Informations de version

.NET Framework

Pris en charge dans : 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

Sécurité .NET Framework

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

Plateformes

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.

Sécurité des threads

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.

Voir aussi

Référence

System.Net, espace de noms

Autres ressources

<defaultProxy>, élément (paramètres réseau)

Modifications apportées à l'authentification NTLM pour HttpWebRequest de la version 3,5 SP1

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Ajouts de la communauté

AJOUTER