HttpWebResponse Clase

Definición

Proporciona una implementación específica de HTTP de la clase 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
Herencia
Atributos
Implementaciones

Ejemplos

En el ejemplo siguiente se devuelve una HttpWebResponse de 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()

Comentarios

Esta clase contiene compatibilidad con los usos específicos de HTTP de las propiedades y los métodos de la clase WebResponse.This class contains support for HTTP-specific uses of the properties and methods of the WebResponse class. La clase HttpWebResponse se usa para crear aplicaciones cliente independientes HTTP que envían solicitudes HTTP y reciben respuestas HTTP.The HttpWebResponse class is used to build HTTP stand-alone client applications that send HTTP requests and receive HTTP responses.

Nota

No confunda HttpWebResponse con la clase HttpResponse que se usa en las aplicaciones ASP.NET y cuyos métodos y propiedades se exponen a través de ASP. Objeto Response intrínseco de la red.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.

Nunca debe crear directamente una instancia de la clase HttpWebResponse.You should never directly create an instance of the HttpWebResponse class. En su lugar, utilice la instancia devuelta por una llamada a HttpWebRequest.GetResponse.Instead, use the instance returned by a call to HttpWebRequest.GetResponse. Debe llamar al método Stream.Close o HttpWebResponse.Close para cerrar la respuesta y liberar la conexión para su reutilización.You must call either the Stream.Close or the HttpWebResponse.Close method to close the response and release the connection for reuse. No es necesario llamar a Stream.Close y HttpWebResponse.Close, pero no se produce un error.It is not necessary to call both Stream.Close and HttpWebResponse.Close, but doing so does not cause an error.

La información de encabezado común devuelta desde el recurso de Internet se expone como propiedades de la clase.Common header information returned from the Internet resource is exposed as properties of the class. Vea la tabla siguiente para obtener una lista completa.See the following table for a complete list. Se pueden leer otros encabezados desde la propiedad Headers como pares de nombre/valor.Other headers can be read from the Headers property as name/value pairs.

En la tabla siguiente se muestran los encabezados HTTP comunes que están disponibles a través de las propiedades de la clase HttpWebResponse.The following table shows the common HTTP headers that are available through properties of the HttpWebResponse class.

HeaderHeader Propiedad.Property
Codificación de contenidoContent-Encoding ContentEncoding
Longitud de contenidoContent-Length ContentLength
Tipo de contenidoContent-Type ContentType
Última modificaciónLast-Modified LastModified
ServidorServer Server

El contenido de la respuesta del recurso de Internet se devuelve como un Stream llamando al método GetResponseStream.The contents of the response from the Internet resource are returned as a Stream by calling the GetResponseStream method.

Constructores

HttpWebResponse()

Inicializa una nueva instancia de la clase HttpWebResponse.Initializes a new instance of the HttpWebResponse class.

HttpWebResponse(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase HttpWebResponse desde las instancias StreamingContext y SerializationInfo.Initializes a new instance of the HttpWebResponse class from the specified SerializationInfo and StreamingContext instances.

Propiedades

CharacterSet

Obtiene el juego de caracteres de la respuesta.Gets the character set of the response.

ContentEncoding

Obtiene el método usado para codificar el cuerpo de la respuesta.Gets the method that is used to encode the body of the response.

ContentLength

Obtiene la longitud del contenido devuelto por la solicitud.Gets the length of the content returned by the request.

ContentType

Obtiene el tipo de contenido de la respuesta.Gets the content type of the response.

Cookies

Obtiene o establece las cookies asociadas a esta respuesta.Gets or sets the cookies that are associated with this response.

Headers

Obtiene los encabezados asociados con esta respuesta del servidor.Gets the headers that are associated with this response from the server.

IsFromCache

Obtiene un valor Boolean que indica si esta respuesta se obtuvo de la caché.Gets a Boolean value that indicates whether this response was obtained from the cache.

(Heredado de WebResponse)
IsMutuallyAuthenticated

Obtiene un valor Boolean que indica si se autenticaron el cliente y el servidor.Gets a Boolean value that indicates whether both client and server were authenticated.

LastModified

Obtiene la fecha y la hora en la que se modificó por última vez el contenido de la respuesta.Gets the last date and time that the contents of the response were modified.

Method

Obtiene el método usado para devolver la respuesta.Gets the method that is used to return the response.

ProtocolVersion

Obtiene la versión del protocolo HTTP usado en la respuesta.Gets the version of the HTTP protocol that is used in the response.

ResponseUri

Obtiene el URI del recurso de Internet que respondió a la solicitud.Gets the URI of the Internet resource that responded to the request.

Server

Obtiene el nombre del servidor que envió la respuesta.Gets the name of the server that sent the response.

StatusCode

Obtiene el estado de la respuesta.Gets the status of the response.

StatusDescription

Obtiene la descripción del estado devuelto con la respuesta.Gets the status description returned with the response.

SupportsHeaders

Obtiene un valor que indica si se admiten encabezados.Gets a value that indicates whether headers are supported.

Métodos

Close()

Cierra la secuencia de respuesta.Closes the response stream.

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera los recursos no administrados que utiliza el objeto WebResponse.Releases the unmanaged resources used by the WebResponse object.

(Heredado de WebResponse)
Dispose(Boolean)

Libera los recursos no administrados que usa HttpWebResponse y, de forma opcional, desecha los recursos administrados.Releases the unmanaged resources used by the HttpWebResponse, and optionally disposes of the managed resources.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Devuelve un valor hash para una instancia de HttpWebResponse.Returns a hash value for a HttpWebResponse instance.

GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)

Llena SerializationInfo con los datos necesarios para serializar el objeto de destino.Populates a SerializationInfo with the data needed to serialize the target object.

GetResponseHeader(String)

Obtiene el contenido de un encabezado que se devolvió con la respuesta.Gets the contents of a header that was returned with the response.

GetResponseStream()

Obtiene la secuencia usada para leer el cuerpo de la respuesta del servidor.Gets the stream that is used to read the body of the response from the server.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

IDisposable.Dispose()

Libera todos los recursos que usa HttpWebResponse.Releases all resources used by the HttpWebResponse.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Serializa esta instancia en el objeto SerializationInfo especificado.Serializes this instance into the specified SerializationInfo object.

Se aplica a

Consulte también: