HttpWebResponse Classe

Définition

Fournit une implémentation propre à HTTP de la classe WebResponse.Provides an HTTP-specific implementation of the WebResponse class.

public ref class HttpWebResponse : System::Net::WebResponse, IDisposable, System::Runtime::Serialization::ISerializable
[System.Serializable]
public class HttpWebResponse : System.Net.WebResponse, IDisposable, System.Runtime.Serialization.ISerializable
type HttpWebResponse = class
    inherit WebResponse
    interface ISerializable
    interface IDisposable
Public Class HttpWebResponse
Inherits WebResponse
Implements IDisposable, ISerializable
Héritage
Attributs
Implémente

Exemples

L’exemple suivant retourne un HttpWebResponse à partir d’un HttpWebRequest.The following example returns an HttpWebResponse from an HttpWebRequest.

HttpWebRequest^ HttpWReq = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.contoso.com" ));
HttpWebResponse^ HttpWResp = dynamic_cast<HttpWebResponse^>(HttpWReq->GetResponse());

// Insert code that uses the response object.
HttpWResp->Close();
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 prend en charge les utilisations spécifiques à HTTP des propriétés et méthodes de la classe WebResponse.This class contains support for HTTP-specific uses of the properties and methods of the WebResponse class. La classe HttpWebResponse est utilisée pour générer des applications clientes autonomes HTTP qui envoient des requêtes HTTP et reçoivent des réponses HTTP.The HttpWebResponse class is used to build HTTP stand-alone client applications that send HTTP requests and receive HTTP responses.

Notes

Ne confondez pas HttpWebResponse avec la classe HttpResponse qui est utilisée dans les applications ASP.NET et dont les méthodes et les propriétés sont exposées par le biais d’ASP. Objet de Response intrinsèque du NET.Do not confuse HttpWebResponse with the HttpResponse class that is used in ASP.NET applications and whose methods and properties are exposed through ASP.NET's intrinsic Response object.

Vous ne devez jamais créer directement une instance de la classe HttpWebResponse.You should never directly create an instance of the HttpWebResponse class. Au lieu de cela, utilisez l’instance retournée par un appel à HttpWebRequest.GetResponse.Instead, use the instance returned by a call to HttpWebRequest.GetResponse. Vous devez appeler la méthode Stream.Close ou HttpWebResponse.Close pour fermer la réponse et libérer la connexion en vue de sa réutilisation.You must call either the Stream.Close or the HttpWebResponse.Close method to close the response and release the connection for reuse. Il n’est pas nécessaire d’appeler à la fois Stream.Close et HttpWebResponse.Close, mais cela ne provoque pas d’erreur.It is not necessary to call both Stream.Close and HttpWebResponse.Close, but doing so does not cause an error.

Les informations d’en-tête communes retournées par la ressource Internet sont exposées en tant que propriétés de la classe.Common header information returned from the Internet resource is exposed as properties of the class. Pour obtenir une liste complète, consultez le tableau suivant.See the following table for a complete list. D’autres en-têtes peuvent être lus à partir de la propriété Headers en tant que paires nom/valeur.Other headers can be read from the Headers property as name/value pairs.

Le tableau suivant répertorie les en-têtes HTTP courants qui sont disponibles par le biais des propriétés de la classe HttpWebResponse.The following table shows the common HTTP headers that are available through properties of the HttpWebResponse class.

HeaderHeader PropertyProperty
Content-EncodingContent-Encoding ContentEncoding
Content-LengthContent-Length ContentLength
Type de contenuContent-Type ContentType
Dernière modificationLast-Modified LastModified
ServeurServer Server

Le contenu de la réponse de la ressource Internet est retourné en tant que Stream en appelant la méthode GetResponseStream.The contents of the response from the Internet resource are returned as a Stream by calling the GetResponseStream method.

Constructeurs

HttpWebResponse()

Initialise une nouvelle instance de la classe HttpWebResponse.Initializes a new instance of the HttpWebResponse class.

HttpWebResponse(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe HttpWebResponse à partir des instances SerializationInfo et StreamingContext spécifiées.Initializes a new instance of the HttpWebResponse class from the specified SerializationInfo and StreamingContext instances.

Propriétés

CharacterSet

Obtient le jeu de caractères de la réponse.Gets the character set of the response.

ContentEncoding

Obtient la méthode qui est utilisée pour encoder le corps de la réponse.Gets the method that is used to encode the body of the response.

ContentLength

Obtient la longueur du contenu retourné par la demande.Gets the length of the content returned by the request.

ContentType

Obtient le type de contenu de la réponse.Gets the content type of the response.

Cookies

Obtient ou définit les cookies qui sont associés à cette réponse.Gets or sets the cookies that are associated with this response.

Headers

Obtient du serveur les en-têtes qui sont associés à cette réponse.Gets the headers that are associated with this response from the server.

IsFromCache

Obtient une valeur Boolean qui indique si cette réponse a été extraite du cache.Gets a Boolean value that indicates whether this response was obtained from the cache.

(Hérité de WebResponse)
IsMutuallyAuthenticated

Obtient une valeur Boolean qui indique si le client et le serveur ont tous les deux été authentifiés.Gets a Boolean value that indicates whether both client and server were authenticated.

LastModified

Obtient la date et l'heure de la dernière modification du contenu de la réponse.Gets the last date and time that the contents of the response were modified.

Method

Obtient la méthode qui est utilisée pour retourner la réponse.Gets the method that is used to return the response.

ProtocolVersion

Obtient la version du protocole HTTP qui est utilisé dans la réponse.Gets the version of the HTTP protocol that is used in the response.

ResponseUri

Obtient l'URI de la ressource Internet qui a répondu à la demande.Gets the URI of the Internet resource that responded to the request.

Server

Obtient le nom du serveur qui a envoyé la réponse.Gets the name of the server that sent the response.

StatusCode

Obtient l'état de la réponse.Gets the status of the response.

StatusDescription

Obtient la description d'état retournée avec la réponse.Gets the status description returned with the response.

SupportsHeaders

Obtient une valeur qui indique si les en-têtes sont pris en charge.Gets a value that indicates whether headers are supported.

Méthodes

Close()

Ferme le flux de réponse.Closes the response stream.

CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Dispose()

Libère les ressources non managées utilisées par l'objet WebResponse.Releases the unmanaged resources used by the WebResponse object.

(Hérité de WebResponse)
Dispose(Boolean)

Libère les ressources non managées utilisées par HttpWebResponse et supprime éventuellement les ressources managées.Releases the unmanaged resources used by the HttpWebResponse, and optionally disposes of the managed resources.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Retourne une valeur de hachage pour une instance de HttpWebResponse.Returns a hash value for a HttpWebResponse instance.

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)

Remplit SerializationInfo avec les données nécessaires pour sérialiser l'objet cible.Populates a SerializationInfo with the data needed to serialize the target object.

GetResponseHeader(String)

Obtient le contenu d'un en-tête qui a été retourné avec la réponse.Gets the contents of a header that was returned with the response.

GetResponseStream()

Obtient le flux qui est utilisé pour lire le corps de la réponse du serveur.Gets the stream that is used to read the body of the response from the server.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Hérité de MarshalByRefObject)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

Implémentations d’interfaces explicites

IDisposable.Dispose()

Libère toutes les ressources utilisées par HttpWebResponse.Releases all resources used by the HttpWebResponse.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Sérialise cette instance dans l'objet SerializationInfo spécifié.Serializes this instance into the specified SerializationInfo object.

S’applique à

Voir aussi