Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase HttpResponse

 

Publicado: octubre de 2016

Encapsula la información de la respuesta HTTP de una operación ASP.NET.

Espacio de nombres:   System.Web
Ensamblado:  System.Web (en System.Web.dll)

System.Object
  System.Web.HttpResponse

public sealed class HttpResponse

NombreDescripción
System_CAPS_pubmethodHttpResponse(TextWriter)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Inicializa una nueva instancia de la clase HttpResponse.

NombreDescripción
System_CAPS_pubpropertyBuffer

Obtiene o establece un valor que indica si los resultados se van a almacenar en el búfer y se van a enviar después de que se haya terminado de procesar la respuesta completa.

System_CAPS_pubpropertyBufferOutput

Obtiene o establece un valor que indica si los resultados se van a almacenar en el búfer y se van a enviar después de que se haya terminado de procesar la página completa.

System_CAPS_pubpropertyCache

Obtiene la directiva de caché (por ejemplo, tiempo de expiración, configuración de privacidad y cláusulas de variación) de una página web.

System_CAPS_pubpropertyCacheControl

Obtiene o establece el encabezado HTTP Cache-Control que coincide con uno de los valores de enumeración HttpCacheability.

System_CAPS_pubpropertyCharset

Obtiene o establece el juego de caracteres HTTP del flujo de salida.

System_CAPS_pubpropertyClientDisconnectedToken

Obtiene un objeto CancellationToken que se desencadena cuando el cliente se desconecta.

System_CAPS_pubpropertyContentEncoding

Obtiene o establece el juego de caracteres HTTP del flujo de salida.

System_CAPS_pubpropertyContentType

Obtiene o establece el tipo MIME HTTP del flujo de salida.

System_CAPS_pubpropertyCookies

Obtiene la colección de cookies de respuesta.

System_CAPS_pubpropertyExpires

Obtiene o establece los minutos que deben transcurrir antes de que expire una página almacenada en la caché de un explorador. Si el usuario vuelve a la misma página antes de que expire, aparece la versión almacenada en caché. Se proporciona Expires para ofrecer compatibilidad con versiones anteriores de ASP.

System_CAPS_pubpropertyExpiresAbsolute

Obtiene o establece el valor absoluto de la fecha y la hora en que se quitará de la memoria caché la información almacenada en ella. Se proporciona ExpiresAbsolute para ofrecer compatibilidad con versiones anteriores de ASP.

System_CAPS_pubpropertyFilter

Obtiene o establece un objeto de filtro contenedor que se emplea para modificar el cuerpo de la entidad HTTP antes de la transmisión.

System_CAPS_pubpropertyHeaderEncoding

Obtiene o establece un objeto Encoding que representa la codificación del flujo de salida del encabezado actual.

System_CAPS_pubpropertyHeaders

Obtiene la colección de encabezados de respuesta.

System_CAPS_pubpropertyHeadersWritten

[Compatible con .NET Framework 4.5.2 y versiones posteriores]

Obtiene un valor que indica si se escribieron los encabezados de respuesta.

System_CAPS_pubpropertyIsClientConnected

Obtiene un valor que indica si el cliente sigue conectado al servidor.

System_CAPS_pubpropertyIsRequestBeingRedirected

Obtiene un valor booleano que indica si el cliente se transfiere a una nueva ubicación.

System_CAPS_pubpropertyOutput

Habilita la salida de texto al flujo de respuesta HTTP saliente.

System_CAPS_pubpropertyOutputStream

Habilita la salida binaria para el cuerpo de contenido HTTP saliente.

System_CAPS_pubpropertyRedirectLocation

Obtiene o establece el valor del encabezado HTTP Location.

System_CAPS_pubpropertyStatus

Establece la línea Status que se devuelve al cliente.

System_CAPS_pubpropertyStatusCode

Obtiene o establece el código de estado HTTP de la salida que se devuelve al cliente.

System_CAPS_pubpropertyStatusDescription

Obtiene o establece la cadena de estado HTTP de la salida que se devuelve al cliente.

System_CAPS_pubpropertySubStatusCode

Obtiene o establece un valor que califica el código de estado de la respuesta.

System_CAPS_pubpropertySupportsAsyncFlush

Obtiene un valor que indica si la conexión admite las operaciones de vaciado asincrónicas.

System_CAPS_pubpropertySuppressContent

Obtiene o establece un valor que indica si se debe enviar el contenido HTTP al cliente.

System_CAPS_pubpropertySuppressDefaultCacheControlHeader

[Compatible con .NET Framework 4.5.2 y versiones posteriores]

Obtiene o establece un valor que indica si se suprime el encabezado Cache Control: private predeterminado de la respuesta HTTP actual.

System_CAPS_pubpropertySuppressFormsAuthenticationRedirect

Obtiene o establece un valor que especifica si el redireccionamiento de autenticación de formularios a la página de inicio de sesión debe suprimirse.

System_CAPS_pubpropertyTrySkipIisCustomErrors

Obtiene o establece un valor que indica si los errores personalizados de IIS 7.0 están deshabilitados.

NombreDescripción
System_CAPS_pubmethodAddCacheDependency(CacheDependency[])

Asocia un conjunto de dependencias de caché a la respuesta para facilitar la invalidación de la respuesta si se almacena en la caché de resultados y las dependencias especificadas cambian.

System_CAPS_pubmethodAddCacheItemDependencies(ArrayList)

Hace que la validez de una respuesta almacenada en caché dependa de otros elementos de la caché.

System_CAPS_pubmethodAddCacheItemDependencies(String[])

Hace que la validez de un elemento almacenado en caché dependa de otro elemento de la caché.

System_CAPS_pubmethodAddCacheItemDependency(String)

Hace que la validez de una respuesta almacenada en caché dependa de otro elemento de la caché.

System_CAPS_pubmethodAddFileDependencies(ArrayList)

Agrega un grupo de nombres de archivo a la colección de nombres de archivo de la que depende la respuesta actual.

System_CAPS_pubmethodAddFileDependencies(String[])

Agrega una matriz de nombres de archivo a la colección de nombres de archivo de la que depende la respuesta actual.

System_CAPS_pubmethodAddFileDependency(String)

Agrega un solo nombre de archivo a la colección de nombres de archivo de la que depende la respuesta actual.

System_CAPS_pubmethodAddHeader(String, String)

Agrega un encabezado HTTP al flujo de salida. Se proporciona AddHeader para ofrecer compatibilidad con versiones anteriores de ASP.

System_CAPS_pubmethodAddOnSendingHeaders(Action<HttpContext>)

[Compatible con .NET Framework 4.5.2 y versiones posteriores]

Registra una devolución de llamada que el runtime de ASP.NET invocará inmediatamente antes de enviar los encabezados de respuesta para esta solicitud.

System_CAPS_pubmethodAppendCookie(HttpCookie)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Agrega una cookie HTTP a la colección de cookies intrínseca.

System_CAPS_pubmethodAppendHeader(String, String)

Agrega un encabezado HTTP al flujo de salida.

System_CAPS_pubmethodAppendToLog(String)

Agrega información de registro personalizada al archivo del registro de Internet Information Services (IIS).

System_CAPS_pubmethodApplyAppPathModifier(String)

Agrega un identificador de sesión a la ruta de acceso virtual si la sesión usa un estado de sesión Cookieless y devuelve la ruta combinada. Si no se usa el estado de sesión Cookieless, ApplyAppPathModifier devuelve la ruta de acceso virtual original.

System_CAPS_pubmethodBeginFlush(AsyncCallback, Object)

Envía al cliente la respuesta almacenada actualmente en el búfer.

System_CAPS_pubmethodBinaryWrite(Byte[])

Escribe una cadena de caracteres binarios en el flujo de salida HTTP.

System_CAPS_pubmethodClear()

Borra toda la salida de contenido del flujo del búfer.

System_CAPS_pubmethodClearContent()

Borra toda la salida de contenido del flujo del búfer.

System_CAPS_pubmethodClearHeaders()

Borra todos los encabezados del flujo del búfer.

System_CAPS_pubmethodClose()

Cierra la conexión del socket con un cliente.

System_CAPS_pubmethodDisableKernelCache()

Deshabilita el almacenamiento en caché en el kernel para la respuesta actual.

System_CAPS_pubmethodDisableUserCache()

Deshabilita el almacenamiento en caché del modo de usuario de IIS para esta respuesta.

System_CAPS_pubmethodEnd()

Envía al cliente toda la salida del búfer actual, detiene la ejecución de la página y genera el evento EndRequest.

System_CAPS_pubmethodEndFlush(IAsyncResult)

Completa una operación de vaciado asincrónico.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodFlush()

Envía al cliente toda la salida almacenada en el búfer.

System_CAPS_pubmethodFlushAsync()

Envía al cliente de forma asincrónica todos los resultados almacenados en el búfer.

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodPics(String)

Anexa un encabezado HTTP PICS-Label al flujo de salida.

System_CAPS_pubmethodPushPromise(String)

Esta API ofrece compatibilidad con aplicaciones que envían compromisos de inserción a los clientes HTTP 2.0. Puede encontrar más detalles relacionados con la inserción de servidor Http2 en HTTP/2 Specification Section 8.2: Server Push.

System_CAPS_pubmethodPushPromise(String, String, NameValueCollection)

Esta API ofrece compatibilidad con aplicaciones que envían compromisos de inserción a los clientes HTTP 2.0. Puede encontrar más detalles relacionados con la inserción de servidor Http2 en HTTP/2 Specification Section 8.2: Server Push.

System_CAPS_pubmethodRedirect(String)

Redirecciona una solicitud a una nueva dirección URL y especifica la nueva URL.

System_CAPS_pubmethodRedirect(String, Boolean)

Redirecciona un cliente a una nueva dirección URL. Especifica la nueva URL y si la ejecución de la página actual debe finalizar.

System_CAPS_pubmethodRedirectPermanent(String)

Realiza un redireccionamiento permanente de la dirección URL solicitada a la dirección URL especificada.

System_CAPS_pubmethodRedirectPermanent(String, Boolean)

Realiza un redireccionamiento permanente de la dirección URL solicitada a la dirección URL especificada y proporciona la opción para completar la respuesta.

System_CAPS_pubmethodRedirectToRoute(Object)

Redirige una solicitud a una nueva dirección URL mediante los valores de parámetro de la ruta.

System_CAPS_pubmethodRedirectToRoute(RouteValueDictionary)

Redirige una solicitud a una nueva dirección URL mediante los valores de parámetro de la ruta.

System_CAPS_pubmethodRedirectToRoute(String)

Redirige una solicitud a una nueva dirección URL mediante un nombre de ruta.

System_CAPS_pubmethodRedirectToRoute(String, Object)

Redirige una solicitud a una nueva dirección URL mediante los valores de parámetro de la ruta y un nombre de ruta.

System_CAPS_pubmethodRedirectToRoute(String, RouteValueDictionary)

Redirige una solicitud a una nueva dirección URL mediante los valores de parámetro de la ruta y un nombre de ruta.

System_CAPS_pubmethodRedirectToRoutePermanent(Object)

Realiza un redireccionamiento permanente de una dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro de la ruta.

System_CAPS_pubmethodRedirectToRoutePermanent(RouteValueDictionary)

Realiza un redireccionamiento permanente de una dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro de la ruta.

System_CAPS_pubmethodRedirectToRoutePermanent(String)

Realiza un redireccionamiento permanente de una dirección URL solicitada a una nueva dirección URL mediante un nombre de ruta.

System_CAPS_pubmethodRedirectToRoutePermanent(String, Object)

Realiza un redireccionamiento permanente de la dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro y el nombre de la ruta que corresponden a la nueva dirección URL.

System_CAPS_pubmethodRedirectToRoutePermanent(String, RouteValueDictionary)

Realiza un redireccionamiento permanente de una dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro de la ruta y un nombre de ruta.

System_CAPS_pubmethodSystem_CAPS_staticRemoveOutputCacheItem(String)

Quita de la memoria caché todos los elementos almacenados que estén asociados al proveedor de caché de resultados predeterminado. Este método es estático.

System_CAPS_pubmethodSystem_CAPS_staticRemoveOutputCacheItem(String, String)

Usa el proveedor de caché de resultados especificado para quitar todos los elementos de caché de resultados que están asociados a la ruta de acceso indicada.

System_CAPS_pubmethodSetCookie(HttpCookie)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Actualiza una cookie existente en la colección de cookies.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_pubmethodTransmitFile(String)

Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP, sin almacenarlo en búfer en memoria.

System_CAPS_pubmethodTransmitFile(String, Int64, Int64)

Escribe la parte especificada de un archivo directamente en un flujo de salida de respuesta HTTP, sin almacenarlo en búfer en memoria.

System_CAPS_pubmethodWrite(Char)

Escribe un carácter en un flujo de salida de respuesta HTTP.

System_CAPS_pubmethodWrite(Char[], Int32, Int32)

Escribe una matriz de caracteres en un flujo de salida de respuesta HTTP.

System_CAPS_pubmethodWrite(Object)

Escribe un Object en un flujo de respuesta HTTP.

System_CAPS_pubmethodWrite(String)

Escribe una cadena en un flujo de salida de respuesta HTTP.

System_CAPS_pubmethodWriteFile(IntPtr, Int64, Int64)

Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP.

System_CAPS_pubmethodWriteFile(String)

Escribe el contenido del archivo especificado directamente en un flujo de salida de respuesta HTTP como un bloque de archivos.

System_CAPS_pubmethodWriteFile(String, Boolean)

Escribe el contenido del archivo especificado directamente en un flujo de salida de respuesta HTTP como un bloque de memoria.

System_CAPS_pubmethodWriteFile(String, Int64, Int64)

Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP.

System_CAPS_pubmethodWriteSubstitution(HttpResponseSubstitutionCallback)

Permite la inserción de bloques de substitución de respuesta en la respuesta, lo que permite la generación dinámica de regiones de respuesta especificadas para las respuestas almacenadas en la caché de resultados.

The methods and properties of the T:System.Web.HttpResponse class are exposed through the P:System.Web.HttpApplication.Response property of the T:System.Web.HttpApplication, T:System.Web.HttpContext, T:System.Web.UI.Page, and T:System.Web.UI.UserControl classes.

The following methods of the T:System.Web.HttpResponse class are supported only in post back scenarios and not in asynchronous post back scenarios:

Partial-page updates are enabled when you use T:System.Web.UI.UpdatePanel controls to update selected regions of a page instead of updating the whole page with a post back. For more information, see UpdatePanel Control Overview and Partial-Page Rendering Overview.

The following example draws three overlapping rectangles when the page is requested. The code begins by setting the P:System.Web.HttpResponse.ContentType property to image/jpeg, so that the entire page will be rendered as a JPEG image. The code then calls the M:System.Web.HttpResponse.Clear method to ensure that no extraneous content is sent with this response. Next, the code sets the P:System.Web.HttpResponse.BufferOutput property to true so that the page is completely processed before it is sent to the requesting client. Two objects used to draw the rectangles are then created: a T:System.Drawing.Bitmap and a T:System.Drawing.Graphics object. The variables created in the page are used as coordinates to draw the rectangles and a string that appears inside the largest rectangle.

When the three rectangles and the string that appears inside them are drawn, the T:System.Drawing.Bitmap is saved to the T:System.IO.Stream object that is associated with the P:System.Web.HttpResponse.OutputStream property and its format is set to JPEG. The code calls the M:System.Drawing.Image.Dispose and M:System.Drawing.Graphics.Dispose methods to release the resources used by the two drawing objects. Lastly, the code calls the M:System.Web.HttpResponse.Flush method to send the buffered response to the requesting client.

System_CAPS_noteNota

In code, the T:System.Web.HttpResponse object is referred to by the keyword Response. For example, Response.Clear() refers to the M:System.Web.HttpResponse.Clear method. The T:System.Web.UI.Page class has a property that is named P:System.Web.UI.Page.Response that exposes the current instance of T:System.Web.HttpResponse.

<%@ Page Language="C#" %>
<%@ import Namespace="System.Drawing" %>
<%@ import Namespace="System.Drawing.Imaging" %>
<%@ import Namespace="System.Drawing.Drawing2D" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    private void Page_Load(object sender, EventArgs e)
    {
        // Set the page's content type to JPEG files
        // and clears all content output from the buffer stream.
        Response.ContentType = "image/jpeg";
        Response.Clear();

        // Buffer response so that page is sent
        // after processing is complete.
        Response.BufferOutput = true;

        // Create a font style.
        Font rectangleFont = new Font(
            "Arial", 10, FontStyle.Bold);

        // Create integer variables.
        int height = 100;
        int width = 200;

        // Create a random number generator and create
        // variable values based on it.
        Random r = new Random();
        int x = r.Next(75);
        int a = r.Next(155);
        int x1 = r.Next(100);

        // Create a bitmap and use it to create a
        // Graphics object.
        Bitmap bmp = new Bitmap(
            width, height, PixelFormat.Format24bppRgb);
        Graphics g = Graphics.FromImage(bmp);

        g.SmoothingMode = SmoothingMode.AntiAlias;
        g.Clear(Color.LightGray);

        // Use the Graphics object to draw three rectangles.
        g.DrawRectangle(Pens.White, 1, 1, width-3, height-3);
        g.DrawRectangle(Pens.Aquamarine, 2, 2, width-3, height-3);
        g.DrawRectangle(Pens.Black, 0, 0, width, height);

        // Use the Graphics object to write a string
        // on the rectangles.
        g.DrawString(
            "ASP.NET Samples", rectangleFont,
            SystemBrushes.WindowText, new PointF(10, 40));

        // Apply color to two of the rectangles.
        g.FillRectangle(
            new SolidBrush(
                Color.FromArgb(a, 255, 128, 255)),
            x, 20, 100, 50);

        g.FillRectangle(
            new LinearGradientBrush(
                new Point(x, 10),
                new Point(x1 + 75, 50 + 30),
                Color.FromArgb(128, 0, 0, 128),
                Color.FromArgb(255, 255, 255, 240)),
            x1, 50, 75, 30);

        // Save the bitmap to the response stream and
        // convert it to JPEG format.
        bmp.Save(Response.OutputStream, ImageFormat.Jpeg);

        // Release memory used by the Graphics object
        // and the bitmap.
        g.Dispose();
        bmp.Dispose();

        // Send the output to the client.
        Response.Flush();
    }

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    </form>
</body>
</html>

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: