HttpWebResponse Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona una implementación específica de HTTP de la WebResponse clase .
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
[<System.Serializable>]
type HttpWebResponse = class
inherit WebResponse
interface ISerializable
interface IDisposable
[<System.Serializable>]
type HttpWebResponse = class
inherit WebResponse
interface ISerializable
Public Class HttpWebResponse
Inherits WebResponse
Public Class HttpWebResponse
Inherits WebResponse
Implements ISerializable
Public Class HttpWebResponse
Inherits WebResponse
Implements IDisposable, ISerializable
- Herencia
- Herencia
- Atributos
- Implementaciones
Ejemplos
En el ejemplo siguiente se devuelve un HttpWebResponse objeto de .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()
Comentarios
Esta clase contiene compatibilidad con usos específicos de HTTP de las propiedades y métodos de la WebResponse clase . La HttpWebResponse clase se usa para compilar aplicaciones cliente independientes HTTP que envían solicitudes HTTP y reciben respuestas HTTP.
Nota:
No confunda HttpWebResponse con la HttpResponse clase que se usa en ASP.NET aplicaciones y cuyos métodos y propiedades se exponen a través de ASP. Objeto intrínseco Response de NET.
Nunca debe crear directamente una instancia de la HttpWebResponse clase . En su lugar, use la instancia devuelta por una llamada a HttpWebRequest.GetResponse. Debe llamar al Stream.Close método o para HttpWebResponse.Close cerrar la respuesta y liberar la conexión para su reutilización. No es necesario llamar a y Stream.CloseHttpWebResponse.Close, pero al hacerlo no se produce un error.
La información de encabezado común devuelta desde el recurso de Internet se expone como propiedades de la clase . Consulte la tabla siguiente para obtener una lista completa. Otros encabezados se pueden leer desde la Headers propiedad como pares nombre-valor.
En la tabla siguiente se muestran los encabezados HTTP comunes que están disponibles a través de las propiedades de la HttpWebResponse clase .
| Cabecera | Propiedad |
|---|---|
| Codificación de Contenido | ContentEncoding |
| Longitud del contenido | ContentLength |
| Tipo de contenido | ContentType |
| Última modificación | LastModified |
| Servidor | Server |
El contenido de la respuesta del recurso de Internet se devuelve como mediante una Stream llamada al GetResponseStream método .
Constructores
| Nombre | Description |
|---|---|
| HttpWebResponse() |
Obsoletos.
Obsoletos.
Obsoletos.
Obsoletos.
Inicializa una nueva instancia de la clase HttpWebResponse. |
| HttpWebResponse(SerializationInfo, StreamingContext) |
Obsoletos.
Obsoletos.
Obsoletos.
Inicializa una nueva instancia de la HttpWebResponse clase a partir de las instancias y StreamingContext especificadasSerializationInfo. |
Propiedades
| Nombre | Description |
|---|---|
| CharacterSet |
Obtiene el juego de caracteres de la respuesta. |
| ContentEncoding |
Obtiene el método que se usa para codificar el cuerpo de la respuesta. |
| ContentLength |
Obtiene la longitud del contenido devuelto por la solicitud. |
| ContentType |
Obtiene el tipo de contenido de la respuesta. |
| Cookies |
Obtiene o establece las cookies asociadas a esta respuesta. |
| Headers |
Obtiene los encabezados asociados a esta respuesta del servidor. |
| IsFromCache |
Obtiene un Boolean valor que indica si esta respuesta se obtuvo de la memoria caché. (Heredado de WebResponse) |
| IsMutuallyAuthenticated |
Obtiene un Boolean valor que indica si se autenticaron tanto el cliente como el servidor. |
| LastModified |
Obtiene la última fecha y hora en que se modificó el contenido de la respuesta. |
| Method |
Obtiene el método que se usa para devolver la respuesta. |
| ProtocolVersion |
Obtiene la versión del protocolo HTTP que se usa en la respuesta. |
| ResponseUri |
Obtiene el URI del recurso de Internet que respondió a la solicitud. |
| Server |
Obtiene el nombre del servidor que envió la respuesta. |
| StatusCode |
Obtiene el estado de la respuesta. |
| StatusDescription |
Obtiene la descripción de estado devuelta con la respuesta. |
| SupportsHeaders |
Obtiene un valor que indica si se admiten encabezados. |
Métodos
| Nombre | Description |
|---|---|
| Close() |
Cierra el flujo de respuesta. |
| CreateObjRef(Type) |
Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject) |
| Dispose() |
Libera los recursos no administrados utilizados por el WebResponse objeto . (Heredado de WebResponse) |
| Dispose(Boolean) |
Libera los recursos no administrados usados por HttpWebResponsey, opcionalmente, elimina los recursos administrados. |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Devuelve un valor hash para una HttpWebResponse instancia de . |
| GetHashCode() |
Actúa como función hash predeterminada. (Heredado de Object) |
| GetLifetimeService() |
Obsoletos.
Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject) |
| GetObjectData(SerializationInfo, StreamingContext) |
Obsoletos.
Obsoletos.
Obsoletos.
Rellena con SerializationInfo los datos necesarios para serializar el objeto de destino. |
| GetResponseHeader(String) |
Obtiene el contenido de un encabezado que se devolvió con la respuesta. |
| GetResponseStream() |
Obtiene la secuencia que se usa para leer el cuerpo de la respuesta del servidor. |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| InitializeLifetimeService() |
Obsoletos.
Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficial del objeto actual MarshalByRefObject . (Heredado de MarshalByRefObject) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IDisposable.Dispose() |
Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código. Libera todos los recursos usados por .HttpWebResponse |
| IDisposable.Dispose() |
Cuando se reemplaza en una clase derivada, libera todos los recursos usados por .WebResponse (Heredado de WebResponse) |
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Obsoletos.
Obsoletos.
Obsoletos.
Serializa esta instancia en el objeto especificado SerializationInfo . |