Compartir a través de


Derivar de WebResponse

La clase WebResponse es clase base abstracta que proporciona las propiedades y los métodos básicos para crear una respuesta específica del protocolo que encaje en el modelo de protocolos conectables de .NET Framework. Las aplicaciones que utilizan la clase WebRequest para solicitar datos a recursos reciben la respuesta en una WebResponse. Los descendentes de WebResponse específicos del protocolo deben implementar los miembros abstractos de la clase WebResponse.

La clase WebRequest asociada debe crear descendentes de WebResponse. Por ejemplo, las instancias de HttpWebResponse sólo se crean como resultado de llamar a HttpWebRequest.GetResponse o a HttpWebRequest.EndGetResponse. Cada WebResponse contiene el resultado de una solicitud a un recurso y no está previsto que se reutilice.

ContentLength (Propiedad)

La propiedad ContentLength indica el número de bytes de datos disponibles en la secuencia devuelta por el método GetResponseStream. La propiedad ContentLength no indica el número de bytes de información de encabezado o de metadatos devueltos por el servidor; solo indica el número de bytes de datos del recurso solicitado.

ContentType (Propiedad)

La propiedad ContentType proporciona toda la información especial que su protocolo requiera que usted envíe al cliente para poder identificar el tipo de contenido enviado por el servidor. Normalmente, es el tipo de contenido MIME de los datos devueltos.

Headers (Propiedad)

La propiedad Headers contiene un conjunto arbitrario de pares de nombre y valor de metadatos asociados a la respuesta. En la propiedad Headers se puede incluir cualquier metadato necesario por el protocolo que pueda expresarse como un par de nombre y valor.

No es necesario utilizar la propiedad Headers para emplear metadatos de encabezado. Los metadatos específicos del protocolo pueden exponerse como propiedades; por ejemplo, la propiedad HttpWebResponse.LastModified expone el encabezado HTTP Last-Modified. Cuando expone metadatos de encabezado como una propiedad, no debe permitir que se establezca la misma propiedad mediante Headers.

ResponseUri (Propiedad)

La propiedad ResponseUri contiene el identificador URI del recurso que proporcionó realmente la respuesta. En el caso de aquellos protocolos que no admitan redirección, ResponseUri será igual que la propiedad RequestUri de la WebRequest que creó la respuesta. Si el protocolo permite redirigir la solicitud, ResponseUri contendrá el identificador URI de la respuesta.

Close (Método)

El método Close cierra todas las conexiones establecidas por la solicitud y la respuesta, y limpia los recursos utilizados por la respuesta. El método Close cierra todas las instancias de secuencias utilizadas por la respuesta, pero no inicia una excepción si una llamada al método Stream.Close cerró previamente la secuencia de respuesta.

GetResponseStream (Método)

El método GetResponseStream devuelve una secuencia que contiene la respuesta del recurso solicitado. La secuencia de respuesta sólo contiene los datos devueltos por el recurso; cualquier encabezado o metadato incluido en la respuesta se debe quitar de la misma y exponerse a la aplicación mediante las propiedades específicas del protocolo o mediante la propiedad Headers.

La instancia de secuencia devuelta por el método GetResponseStream es propiedad de la aplicación y se puede cerrar sin cerrar la WebResponse. Por convención, la llamada al método WebResponse.Close también cierra la secuencia devuelta por GetResponse.

Vea también

Programar protocolos conectables | Derivar de WebRequest | WebResponse (Clase) | HttpWebResponse (Clase) | FileWebResponse (Clase)