Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe HttpResponse

 

Encapsula informações de resposta HTTP de uma operação do ASP.NET.

Namespace:   System.Web
Assembly:  System.Web (em System.Web.dll)

System.Object
  System.Web.HttpResponse

public sealed class HttpResponse

NomeDescrição
System_CAPS_pubmethodHttpResponse(TextWriter)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Inicializa uma nova instância da classe HttpResponse.

NomeDescrição
System_CAPS_pubpropertyBuffer

Obtém ou define um valor que indica se o buffer de saída e enviá-lo após a resposta completa concluiu o processamento.

System_CAPS_pubpropertyBufferOutput

Obtém ou define um valor que indica se o buffer de saída e enviá-lo após a página concluída concluiu o processamento.

System_CAPS_pubpropertyCache

Obtém a política de cache (como a expiração do tempo, as configurações de privacidade e variar cláusulas) de uma página da Web.

System_CAPS_pubpropertyCacheControl

Obtém ou define o Cache-Control cabeçalho HTTP, que corresponde a um do HttpCacheability valores de enumeração.

System_CAPS_pubpropertyCharset

Obtém ou define o conjunto de caracteres HTTP do fluxo de saída.

System_CAPS_pubpropertyClientDisconnectedToken

Obtém uma CancellationToken objeto que é disparado quando o cliente se desconecta.

System_CAPS_pubpropertyContentEncoding

Obtém ou define o conjunto de caracteres HTTP do fluxo de saída.

System_CAPS_pubpropertyContentType

Obtém ou define o tipo MIME de HTTP do fluxo de saída.

System_CAPS_pubpropertyCookies

Obtém a coleção de cookies de resposta.

System_CAPS_pubpropertyExpires

Obtém ou define o número de minutos antes de expira uma página armazenada em cache em um navegador. Se o usuário retornar para a mesma página antes de expirar, a versão em cache é exibida. Expires é fornecido para compatibilidade com versões anteriores do ASP.

System_CAPS_pubpropertyExpiresAbsolute

Obtém ou define a data absoluta e a hora na qual remover informações armazenadas em cache do cache. ExpiresAbsolute é fornecido para compatibilidade com versões anteriores do ASP.

System_CAPS_pubpropertyFilter

Obtém ou define um filtro de encapsulamento do objeto que é usado para modificar o corpo da entidade HTTP antes da transmissão.

System_CAPS_pubpropertyHeaderEncoding

Obtém ou define um Encoding fluxo de saída do objeto que representa a codificação para o cabeçalho atual.

System_CAPS_pubpropertyHeaders

Obtém a coleção de cabeçalhos de resposta.

System_CAPS_pubpropertyHeadersWritten

[Com suporte no .NET Framework 4.5.2 e versões posteriores]

Obtém um valor que indica se os cabeçalhos de resposta foram gravados.

System_CAPS_pubpropertyIsClientConnected

Obtém um valor que indica se o cliente ainda está conectado ao servidor.

System_CAPS_pubpropertyIsRequestBeingRedirected

Obtém um valor booliano que indica se o cliente está sendo transferido para um novo local.

System_CAPS_pubpropertyOutput

Habilita a saída de texto para o fluxo de resposta HTTP de saída.

System_CAPS_pubpropertyOutputStream

Habilita a saída binária para o corpo de conteúdo HTTP saída.

System_CAPS_pubpropertyRedirectLocation

Obtém ou define o valor de HTTP Location cabeçalho.

System_CAPS_pubpropertyStatus

Conjuntos de Status linha é retornada ao cliente.

System_CAPS_pubpropertyStatusCode

Obtém ou define o código de status HTTP da saída retornada ao cliente.

System_CAPS_pubpropertyStatusDescription

Obtém ou define a cadeia de caracteres de status HTTP de saída retornada ao cliente.

System_CAPS_pubpropertySubStatusCode

Obtém ou define um valor que o código de status da resposta de qualificação.

System_CAPS_pubpropertySupportsAsyncFlush

Obtém um valor que indica se a conexão dá suporte a operações assíncronas de liberação.

System_CAPS_pubpropertySuppressContent

Obtém ou define um valor que indica se deseja enviar o conteúdo do HTTP para o cliente.

System_CAPS_pubpropertySuppressDefaultCacheControlHeader

[Com suporte no .NET Framework 4.5.2 e versões posteriores]

Obtém ou define um valor que indica se deve ser suprimida padrão Cache Control: private cabeçalho de resposta HTTP atual.

System_CAPS_pubpropertySuppressFormsAuthenticationRedirect

Obtém ou define um valor que especifica se o redirecionamento de autenticação de formulários para a página de logon deve ser suprimido.

System_CAPS_pubpropertyTrySkipIisCustomErrors

Obtém ou define um valor que especifica se IIS 7.0 erros personalizados estão desabilitados.

NomeDescrição
System_CAPS_pubmethodAddCacheDependency(CacheDependency[])

Associa um conjunto de dependências de cache com a resposta para facilitar a invalidação da resposta se ela é armazenada no cache de saída e alterar as dependências especificadas.

System_CAPS_pubmethodAddCacheItemDependencies(ArrayList)

Torna a validade de uma resposta em cache dependente de outros itens no cache.

System_CAPS_pubmethodAddCacheItemDependencies(String[])

Torna a validade de um item em cache dependente de outro item no cache.

System_CAPS_pubmethodAddCacheItemDependency(String)

Torna a validade de uma resposta em cache dependente de outro item no cache.

System_CAPS_pubmethodAddFileDependencies(ArrayList)

Adiciona um grupo de nomes de arquivo para a coleção de nomes de arquivo no qual a resposta atual é dependente.

System_CAPS_pubmethodAddFileDependencies(String[])

Adiciona uma matriz de nomes de arquivo para a coleção de nomes de arquivo no qual a resposta atual é dependente.

System_CAPS_pubmethodAddFileDependency(String)

Adiciona um nome de arquivo único para a coleção de nomes de arquivo no qual a resposta atual é dependente.

System_CAPS_pubmethodAddHeader(String, String)

Adiciona um cabeçalho HTTP para o fluxo de saída. AddHeader é fornecido para compatibilidade com versões anteriores do ASP.

System_CAPS_pubmethodAddOnSendingHeaders(Action<HttpContext>)

[Com suporte no .NET Framework 4.5.2 e versões posteriores]

Registra um retorno de chamada que o runtime do ASP.NET chamará imediatamente antes da resposta cabeçalhos são enviados para esta solicitação.

System_CAPS_pubmethodAppendCookie(HttpCookie)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Adiciona um cookie HTTP para a coleção de cookie intrínseco.

System_CAPS_pubmethodAppendHeader(String, String)

Adiciona um cabeçalho HTTP ao fluxo de saída.

System_CAPS_pubmethodAppendToLog(String)

Adiciona informações de log personalizado para o arquivo de log de serviços de informações da Internet (IIS).

System_CAPS_pubmethodApplyAppPathModifier(String)

Adiciona uma identificação de sessão para o caminho virtual se a sessão está usando Cookieless estado de sessão e retorna o caminho combinado. Se Cookieless o estado da sessão não for usado, ApplyAppPathModifier retorna o caminho virtual original.

System_CAPS_pubmethodBeginFlush(AsyncCallback, Object)

Envia a resposta em buffer no momento para o cliente.

System_CAPS_pubmethodBinaryWrite(Byte[])

Grava uma cadeia de caracteres binários no fluxo de saída HTTP.

System_CAPS_pubmethodClear()

Limpa todo o conteúdo saída do fluxo de buffer.

System_CAPS_pubmethodClearContent()

Limpa todo o conteúdo saída do fluxo de buffer.

System_CAPS_pubmethodClearHeaders()

Limpa todos os cabeçalhos do fluxo de buffer.

System_CAPS_pubmethodClose()

Fecha a conexão de soquete para um cliente.

System_CAPS_pubmethodDisableKernelCache()

Desabilita o cache de kernel para a resposta atual.

System_CAPS_pubmethodDisableUserCache()

Desabilita o cache de modo de usuário do IIS para esta resposta.

System_CAPS_pubmethodEnd()

Envia todas as saídas em buffer no momento para o cliente, interrompe a execução da página e gera o EndRequest evento.

System_CAPS_pubmethodEndFlush(IAsyncResult)

Conclui uma operação assíncrona de liberação.

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_pubmethodFlush()

Envia toda a saída em buffer no momento para o cliente.

System_CAPS_pubmethodFlushAsync()

Envia de forma assíncrona atualmente em buffer toda a saída para o cliente.

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodPics(String)

Acrescenta uma HTTP PICS-Label cabeçalho para o fluxo de saída.

System_CAPS_pubmethodPushPromise(String)

Essa API é oferecer suporte a aplicativos clientes HTTP 2.0 promete push envio. Você pode encontrar mais detalhes em relação ao envio para servidor Http2 em HTTP/2 Specification Section 8.2: Server Push.

System_CAPS_pubmethodPushPromise(String, String, NameValueCollection)

Essa API é oferecer suporte a aplicativos clientes HTTP 2.0 promete push envio. Você pode encontrar mais detalhes em relação ao envio para servidor Http2 em HTTP/2 Specification Section 8.2: Server Push.

System_CAPS_pubmethodRedirect(String)

Redireciona uma solicitação para uma nova URL e especifica a nova URL.

System_CAPS_pubmethodRedirect(String, Boolean)

Redireciona um cliente para uma nova URL. Especifica a nova URL e se a execução da página atual deve ser terminada.

System_CAPS_pubmethodRedirectPermanent(String)

Executa um redirecionamento permanente da URL solicitada para a URL especificada.

System_CAPS_pubmethodRedirectPermanent(String, Boolean)

Executa um redirecionamento permanente da URL solicitada para a URL especificada e oferece a opção de concluir a resposta.

System_CAPS_pubmethodRedirectToRoute(Object)

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota.

System_CAPS_pubmethodRedirectToRoute(RouteValueDictionary)

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota.

System_CAPS_pubmethodRedirectToRoute(String)

Redireciona uma solicitação para uma nova URL usando um nome de rota.

System_CAPS_pubmethodRedirectToRoute(String, Object)

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota e um nome de rota.

System_CAPS_pubmethodRedirectToRoute(String, RouteValueDictionary)

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota e um nome de rota.

System_CAPS_pubmethodRedirectToRoutePermanent(Object)

Executa um redirecionamento permanente de um URL solicitada para uma nova URL usando valores de parâmetro de rota.

System_CAPS_pubmethodRedirectToRoutePermanent(RouteValueDictionary)

Executa um redirecionamento permanente de um URL solicitada para uma nova URL usando valores de parâmetro de rota.

System_CAPS_pubmethodRedirectToRoutePermanent(String)

Executa um redirecionamento permanente de uma URL solicitada para uma nova URL, usando um nome de rota.

System_CAPS_pubmethodRedirectToRoutePermanent(String, Object)

Executa um redirecionamento permanente de uma URL solicitada para uma nova URL, usando os valores de parâmetro de rota e o nome da rota que corresponde à nova URL.

System_CAPS_pubmethodRedirectToRoutePermanent(String, RouteValueDictionary)

Executa um redirecionamento permanente de um URL solicitada para uma nova URL usando valores de parâmetro de rota e um nome de rota.

System_CAPS_pubmethodSystem_CAPS_staticRemoveOutputCacheItem(String)

Remove do cache em cache todos os itens que estão associados com o provedor de cache de saída padrão. Esse método é estático.

System_CAPS_pubmethodSystem_CAPS_staticRemoveOutputCacheItem(String, String)

Usa o provedor especificado do cache de saída para remover todos os itens no cache de saída que estão associados com o caminho especificado.

System_CAPS_pubmethodSetCookie(HttpCookie)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Atualiza um cookie existente na coleção de cookie.

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

System_CAPS_pubmethodTransmitFile(String)

Grava o arquivo especificado diretamente para um fluxo de saída de resposta HTTP, sem armazenamento em buffer na memória.

System_CAPS_pubmethodTransmitFile(String, Int64, Int64)

Grava a parte especificada de um arquivo diretamente em um fluxo de saída de resposta HTTP sem armazenamento em buffer na memória.

System_CAPS_pubmethodWrite(Char)

Grava um caractere em um fluxo de saída de resposta HTTP.

System_CAPS_pubmethodWrite(Char[], Int32, Int32)

Grava uma matriz de caracteres em um fluxo de saída de resposta HTTP.

System_CAPS_pubmethodWrite(Object)

Grava um Object um fluxo de resposta HTTP.

System_CAPS_pubmethodWrite(String)

Grava uma cadeia de caracteres em um fluxo de saída de resposta HTTP.

System_CAPS_pubmethodWriteFile(IntPtr, Int64, Int64)

Grava o arquivo especificado diretamente para um fluxo de saída de resposta HTTP.

System_CAPS_pubmethodWriteFile(String)

Grava o conteúdo do arquivo especificado diretamente em um fluxo de saída de resposta HTTP como um bloco de arquivo.

System_CAPS_pubmethodWriteFile(String, Boolean)

Grava o conteúdo do arquivo especificado diretamente em um fluxo de saída de resposta HTTP como um bloco de memória.

System_CAPS_pubmethodWriteFile(String, Int64, Int64)

Grava o arquivo especificado diretamente para um fluxo de saída de resposta HTTP.

System_CAPS_pubmethodWriteSubstitution(HttpResponseSubstitutionCallback)

Permite a inserção de blocos de substituição de resposta em resposta, que permite a geração dinâmica de regiões de resposta especificado para respostas de saída em cache.

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_noteObservação

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
Disponível desde 1.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: