HttpWebResponse Classe

Définition

Espace de noms:

System.Net

Assemblys:

netstandard.dll, System.Net.Requests.dll

Source:

HttpWebResponse.cs

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

public ref class HttpWebResponse : System::Net::WebResponse, System::Runtime::Serialization::ISerializable

public class HttpWebResponse : System.Net.WebResponse, System.Runtime.Serialization.ISerializable

type HttpWebResponse = class
    inherit WebResponse
    interface ISerializable

Public Class HttpWebResponse
Inherits WebResponse
Implements ISerializable

Héritage

Object

MarshalByRefObject

WebResponse

HttpWebResponse

Implémente

ISerializable

Exemples

L’exemple suivant retourne une HttpWebResponse valeur à partir d’un HttpWebRequest.

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

HttpWebResponse HttpWResp = (HttpWebResponse)HttpWReq.GetResponse();
// Insert code that uses the response object.
HttpWResp.Close();

Dim HttpWReq As HttpWebRequest = _
   CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
       
Dim HttpWResp As HttpWebResponse = _
   CType(HttpWReq.GetResponse(), HttpWebResponse)
' Insert code that uses the response object.
HttpWResp.Close()

Remarques

Cette classe contient la prise en charge des utilisations spécifiques à HTTP des propriétés et méthodes de la WebResponse classe. La HttpWebResponse classe est utilisée pour générer des applications clientes HTTP autonomes qui envoient des requêtes HTTP et reçoivent des réponses HTTP.

Note

Ne confondez HttpWebResponse pas avec la HttpResponse classe utilisée dans ASP.NET applications et dont les méthodes et propriétés sont exposées via ASP. Objet intrinsèque Response de NET.

Vous ne devez jamais créer directement une instance de la HttpWebResponse classe. Utilisez plutôt l’instance retournée par un appel à HttpWebRequest.GetResponse. Vous devez appeler la ou la Stream.CloseHttpWebResponse.Close méthode pour fermer la réponse et libérer la connexion à des fins de réutilisation. Il n’est pas nécessaire d’appeler les deux Stream.Close et HttpWebResponse.Close, mais cela ne provoque pas d’erreur.

Les informations d’en-tête courantes retournées par la ressource Internet sont exposées en tant que propriétés de la classe. Consultez le tableau suivant pour obtenir une liste complète. D’autres en-têtes peuvent être lus à partir de la Headers propriété en tant que paires nom/valeur.

Le tableau suivant présente les en-têtes HTTP courants disponibles via les propriétés de la HttpWebResponse classe.

Header	Propriété
Encodage du contenu	ContentEncoding
Longueur du contenu	ContentLength
Type de contenu	ContentType
Dernière modification	LastModified
Serveur	Server

Le contenu de la réponse de la ressource Internet est retourné en tant qu’appel Stream de la GetResponseStream méthode.

Constructeurs

Nom	Description
HttpWebResponse()	Obsolète. Initialise une nouvelle instance de la classe HttpWebResponse.
HttpWebResponse(SerializationInfo, StreamingContext)	Obsolète. Initialise une nouvelle instance de la HttpWebResponse classe à partir des instances et des instances spécifiées SerializationInfoStreamingContext .

Propriétés

Nom	Description
CharacterSet	Obtient le jeu de caractères de la réponse.
ContentEncoding	Obtient la méthode utilisée pour encoder le corps de la réponse.
ContentLength	Obtient la longueur du contenu retourné par la requête.
ContentType	Obtient le type de contenu de la réponse.
Cookies	Obtient ou définit les cookies associés à cette réponse.
Headers	Obtient les en-têtes associés à cette réponse du serveur.
IsFromCache	Obtient une Boolean valeur qui indique si cette réponse a été obtenue à partir du cache. (Hérité de WebResponse)
IsMutuallyAuthenticated	Obtient une Boolean valeur qui indique si le client et le serveur ont été authentifiés.
LastModified	Obtient la date et l’heure de la dernière modification du contenu de la réponse.
Method	Obtient la méthode utilisée pour retourner la réponse.
ProtocolVersion	Obtient la version du protocole HTTP utilisé dans la réponse.
ResponseUri	Obtient l’URI de la ressource Internet qui a répondu à la requête.
Server	Obtient le nom du serveur qui a envoyé la réponse.
StatusCode	Obtient l’état de la réponse.
StatusDescription	Obtient la description de l’état retournée avec la réponse.
SupportsHeaders	Obtient une valeur qui indique si les en-têtes sont pris en charge.

Méthodes

Nom	Description
Close()	Ferme le flux de réponse.
Dispose()	Libère les ressources non managées utilisées par l’objet WebResponse . (Hérité de WebResponse)
Dispose(Boolean)	Libère les ressources non managées utilisées par le HttpWebResponse, et supprime éventuellement les ressources gérées.
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 les SerializationInfo données nécessaires pour sérialiser l’objet cible.
GetResponseHeader(String)	Obtient le contenu d’un en-tête retourné avec la réponse.
GetResponseStream()	Obtient le flux utilisé pour lire le corps de la réponse du serveur.
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. Sérialise cette instance dans l’objet spécifié SerializationInfo .

Voir aussi

• WebResponse