Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Personas que lo han encontrado útil: 1 de 1 - Valorar este tema

HttpResponse (Clase)

.NET Framework 4

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

System.Object
  System.Web.HttpResponse

Espacio de nombres:  System.Web
Ensamblado:  System.Web (en System.Web.dll)
C#
C++
F#
VB
Copiar 
public sealed class HttpResponse

El tipo HttpResponse expone los siguientes miembros.

  Nombre Descripción
Método público HttpResponse Infraestructura. Inicializa una nueva instancia de la clase HttpResponse.
Arriba
  Nombre Descripción
Propiedad pública Buffer 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.
Propiedad pública BufferOutput 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.
Propiedad pública Cache 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.
Propiedad pública CacheControl Obtiene o establece el encabezado HTTP Cache-Control que coincide con uno de los valores de enumeración HttpCacheability.
Propiedad pública Charset Obtiene o establece el juego de caracteres HTTP del flujo de salida.
Propiedad pública ContentEncoding Obtiene o establece el juego de caracteres HTTP del flujo de salida.
Propiedad pública ContentType Obtiene o establece el tipo MIME HTTP del flujo de salida.
Propiedad pública Cookies Obtiene la colección de cookies de respuesta.
Propiedad pública Expires 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 memoria caché. Se proporciona la propiedad Expires para ofrecer compatibilidad con versiones anteriores de ASP.
Propiedad pública ExpiresAbsolute 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 la propiedad ExpiresAbsolute para ofrecer compatibilidad con versiones anteriores de ASP.
Propiedad pública Filter Obtiene o establece un objeto de filtro contenedor que se emplea para modificar el cuerpo de la entidad HTTP antes de la transmisión.
Propiedad pública HeaderEncoding Obtiene o establece un objeto Encoding que representa el código del flujo de salida del encabezado actual.
Propiedad pública Headers Obtiene la colección de encabezados de respuesta.
Propiedad pública IsClientConnected Obtiene un valor que indica si el cliente sigue conectado al servidor.
Propiedad pública IsRequestBeingRedirected Obtiene un valor booleano que indica si el cliente se transfiere a una nueva ubicación.
Propiedad pública Output Habilita la salida de texto a la secuencia de respuesta HTTP saliente.
Propiedad pública OutputStream Habilita la salida binaria para el cuerpo de contenido HTTP saliente.
Propiedad pública RedirectLocation Obtiene o establece el valor del encabezado HTTP Location.
Propiedad pública Status Establece la línea Status que se devuelve al cliente.
Propiedad pública StatusCode Obtiene o establece el código de estado de HTTP de la salida que se devuelve al cliente.
Propiedad pública StatusDescription Obtiene o establece la cadena de estado de HTTP de la salida que se devuelve al cliente.
Propiedad pública SubStatusCode Obtiene o establece un valor que califica el código de estado de la respuesta.
Propiedad pública SuppressContent Obtiene o establece un valor que indica si se debe enviar el contenido HTTP al cliente.
Propiedad pública TrySkipIisCustomErrors Obtiene o establece un valor que indica si los errores personalizados de IIS 7.0 están deshabilitados.
Arriba
  Nombre Descripción
Método público AddCacheDependency Asocia un conjunto de dependencias de caché a la respuesta para facilitar invalidación de la respuesta si se almacena en la caché de resultados y las dependencias especificadas cambian.
Método público AddCacheItemDependencies(ArrayList) Valida una respuesta almacenada en caché que depende de otros elementos de la caché.
Método público AddCacheItemDependencies(String[]) Valida un archivo almacenado en caché que depende de otro elemento de la caché.
Método público AddCacheItemDependency Valida una respuesta almacenada en caché que depende de otro elemento de la caché.
Método público AddFileDependencies(ArrayList) Agrega un grupo de nombres de archivo a la colección de nombres de archivo de la que depende la respuesta actual.
Método público AddFileDependencies(String[]) Agrega una matriz de nombres de archivo a la colección de nombres de archivo de la que depende la respuesta actual.
Método público AddFileDependency Agrega un solo nombre de archivo a la colección de nombres de archivo de la que depende la respuesta actual.
Método público AddHeader Agrega un encabezado HTTP al flujo de salida. Se proporciona el método AddHeader para ofrecer compatibilidad con versiones anteriores de ASP.
Método público AppendCookie Infraestructura. Agrega una cookie HTTP a la colección de cookies intrínseca.
Método público AppendHeader Agrega un encabezado HTTP al flujo de salida.
Método público AppendToLog Agrega información de registro personalizada al archivo del registro de Internet Information Services (IIS).
Método público ApplyAppPathModifier Agrega un identificador de sesión a la ruta de acceso virtual, si la sesión utiliza un estado de sesión Cookieless y devuelve la ruta combinada. Si no se utiliza el estado de sesión Cookieless, ApplyAppPathModifier devuelve la ruta de acceso virtual original.
Método público BinaryWrite Escribe una cadena de caracteres binarios en el flujo de salida HTTP.
Método público Clear Borra toda la salida de contenido de la secuencia del búfer.
Método público ClearContent Borra toda la salida de contenido de la secuencia del búfer.
Método público ClearHeaders Borra todos los encabezados de la secuencia del búfer.
Método público Close Cierra la conexión del socket con un cliente.
Método público DisableKernelCache Deshabilita el almacenamiento en caché en el kernel para la respuesta actual.
Método público End Envía al cliente toda la salida del búfer actual, detiene la ejecución de la página y provoca el evento EndRequest.
Método público Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido Finalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método público Flush Envía al cliente toda la salida almacenada en el búfer.
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método público Pics Anexa un encabezado HTTP PICS-Label al flujo de salida.
Método público Redirect(String) Redirecciona una solicitud a una nueva dirección URL y especifica la nueva URL.
Método público Redirect(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.
Método público RedirectPermanent(String) Realiza una redirección permanente de la dirección URL solicitada a la dirección URL especificada.
Método público RedirectPermanent(String, Boolean) Realiza una redirección permanente de la dirección URL solicitada a la dirección URL especificada y proporciona la opción para completar la respuesta.
Método público RedirectToRoute(Object) Redirige una solicitud a una nueva dirección URL usando los valores de parámetro de la ruta.
Método público RedirectToRoute(RouteValueDictionary) Redirige una solicitud a una nueva dirección URL usando los valores de parámetro de la ruta.
Método público RedirectToRoute(String) Redirige una solicitud a una nueva dirección URL usando un nombre de ruta.
Método público RedirectToRoute(String, Object) Redirige una solicitud a una nueva dirección URL usando los valores de parámetro de la ruta y un nombre de ruta.
Método público RedirectToRoute(String, RouteValueDictionary) Redirige una solicitud a una nueva dirección URL usando los valores de parámetro de la ruta y un nombre de ruta.
Método público RedirectToRoutePermanent(Object) Realiza una redirección permanente desde una dirección URL solicitada hasta una nueva dirección URL usando los valores de parámetro de la ruta.
Método público RedirectToRoutePermanent(RouteValueDictionary) Realiza una redirección permanente desde una dirección URL solicitada hasta una nueva dirección URL usando los valores de parámetro de la ruta.
Método público RedirectToRoutePermanent(String) Realiza una redirección permanente desde una dirección URL solicitada hasta una nueva dirección URL usando un nombre de ruta.
Método público RedirectToRoutePermanent(String, Object) Realiza una redirección permanente desde la dirección URL solicitada hasta una nueva dirección URL usando los valores de parámetro y el nombre de la ruta que corresponden a la nueva dirección URL.
Método público RedirectToRoutePermanent(String, RouteValueDictionary) Realiza una redirección permanente desde una dirección URL solicitada hasta una nueva dirección URL usando los valores de parámetro de la ruta y un nombre de ruta.
Método público Miembro estático RemoveOutputCacheItem(String) Quita de la memoria caché todos los elementos almacenados en caché que estén asociados al proveedor de caché de resultados predeterminado. Este método es estático.
Método público Miembro estático RemoveOutputCacheItem(String, String) Usa el proveedor de caché de resultados especificado para quitar todos los elementos de la memoria caché de resultados que están asociados a la ruta de acceso especificada.
Método público SetCookie Infraestructura. Actualiza una cookie existente en la colección de cookies.
Método público ToString Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
Método público TransmitFile(String) Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP, sin almacenarlo en búfer en memoria.
Método público TransmitFile(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.
Método público Write(Char) Escribe un carácter en un flujo de salida de respuesta HTTP.
Método público Write(Object) Escribe un Object en un flujo de respuesta HTTP.
Método público Write(String) Escribe una cadena en un flujo de salida de respuesta HTTP.
Método público Write(Char[], Int32, Int32) Escribe una matriz de caracteres en un flujo de salida de respuesta HTTP.
Método público WriteFile(String) Escribe el contenido del archivo especificado directamente en un flujo de salida de respuesta HTTP como un bloque de archivos.
Método público WriteFile(String, Boolean) Escribe el contenido del archivo especificado directamente en un flujo de salida de respuesta HTTP como un bloque de memoria.
Método público WriteFile(IntPtr, Int64, Int64) Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP.
Método público WriteFile(String, Int64, Int64) Escribe el archivo especificado directamente en un flujo de salida de respuesta HTTP.
Método público WriteSubstitution 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.
Arriba

Los métodos y propiedades de la clase HttpResponse se exponen a través de la propiedad Response de las clases HttpApplication, HttpContext, Page y UserControl.

Los métodos siguientes de la clase HttpResponse sólo se admiten en escenarios de devolución de datos, y no en escenarios de devolución de datos asincrónica:

Al utilizar los controles UpdatePanel para actualizar regiones seleccionadas de una página en lugar de actualizar la página entera con una devolución de datos, se habilitan las actualizaciones de página parciales. Para obtener más información, vea Información general sobre el control UpdatePanel y Información general sobre la representación parcial de páginas.

El ejemplo siguiente dibuja tres rectángulos superpuestos cuando se solicita la página. El código comienza estableciendo la propiedad ContentType en image/jpeg, para que toda la página se represente como imagen JPEG. A continuación, el código llama al método Clear para garantizar que no se envíe contenido extraño con esta respuesta. Luego, el código establece la propiedad BufferOutput en true para que la página se procese en su totalidad antes de enviarla al cliente solicitante. A continuación, se crean dos objetos para dibujar los rectángulos: un objeto Bitmap y un objeto Graphics. Las variables creadas en la página se utilizan como coordenadas para dibujar los rectángulos y una cadena que aparece dentro del rectángulo más grande.

Cuando los tres rectángulos y la cadena que aparece dentro de ellos se han dibujado, Bitmap se guarda en el objeto Stream que está asociado a la propiedad OutputStream y su formato se establece en JPEG. El código llama a los métodos Dispose y Dispose para liberar los recursos utilizados por los dos objetos de dibujo. Por último, el código llama al método Flush para enviar la respuesta almacenada en búfer al cliente solicitante.

Nota Nota

En el código, se hace referencia al objeto HttpResponse por la palabra clave Response. Por ejemplo, Response.Clear() se refiere al método HttpResponse.Clear. La clase Page tiene una propiedad denominada Response que expone la instancia actual de HttpResponse.

C#
VB
Copiar 

<%@ 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

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes