HttpWebResponse Class

Definition

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
public ref class HttpWebResponse : System::Net::WebResponse, System::Runtime::Serialization::ISerializable
public ref class HttpWebResponse : System::Net::WebResponse, IDisposable, System::Runtime::Serialization::ISerializable
public class HttpWebResponse : System.Net.WebResponse
public class HttpWebResponse : System.Net.WebResponse, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class HttpWebResponse : System.Net.WebResponse, IDisposable, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class HttpWebResponse : System.Net.WebResponse, System.Runtime.Serialization.ISerializable
type HttpWebResponse = class
    inherit WebResponse
type HttpWebResponse = class
    inherit WebResponse
    interface ISerializable
type HttpWebResponse = class
    inherit WebResponse
    interface ISerializable
    interface IDisposable
Public Class HttpWebResponse
Inherits WebResponse
Public Class HttpWebResponse
Inherits WebResponse
Implements ISerializable
Public Class HttpWebResponse
Inherits WebResponse
Implements IDisposable, ISerializable
Inheritance
HttpWebResponse
Inheritance
Attributes
Implements

Examples

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()

Remarks

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.

Note

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.

En-têteHeader PropriétéProperty
Content-EncodingContent-Encoding ContentEncoding
Content-LengthContent-Length ContentLength
Content-TypeContent-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.

Constructors

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.

Properties

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.

(Inherited from 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.

IsMutuallyAuthenticated

Obtient une valeur Boolean indiquant si l'authentification mutuelle s'est produite.Gets a Boolean value that indicates whether mutual authentication occurred.

(Inherited from WebResponse)
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.

SupportsHeaders

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

(Inherited from WebResponse)

Methods

Close()

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

Close()

En cas de substitution par une classe descendante, ferme le flux de réponse.When overridden by a descendant class, closes the response stream.

(Inherited from WebResponse)
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.

(Inherited from MarshalByRefObject)
Dispose()

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

(Inherited from 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.

Dispose(Boolean)

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

(Inherited from WebResponse)
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.

(Inherited from Object)
GetHashCode()

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

GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

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

(Inherited from MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)

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

GetObjectData(SerializationInfo, StreamingContext)

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

(Inherited from WebResponse)
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.

(Inherited from 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.

(Inherited from MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
ToString()

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

(Inherited from Object)

Explicit Interface Implementations

IDisposable.Dispose()

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

IDisposable.Dispose()

En cas de substitution dans une classe dérivée, libère toutes les ressources utilisées par WebResponse.When overridden in a derived class, releases all resources used by the WebResponse.

(Inherited from WebResponse)
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Remplit une instance de SerializationInfo avec les données nécessaires pour sérialiser WebResponse.Populates a SerializationInfo instance with the data that is needed to serialize WebResponse.

(Inherited from WebResponse)

Applies to

See also