Home Biblioteca Aprender Galeria Downloads Suporte Comunidade Fóruns
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Este tópico ainda não foi avaliado como - Avalie este tópico

Classe HttpResponse

.NET Framework 4.5

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

System.Object
  System.Web.HttpResponse

Namespace:  System.Web
Assembly:  System.Web (em System.Web.dll)
C#
C++
F#
VB
Copiar 
public sealed class HttpResponse

O tipo HttpResponse expõe os membros a seguir.

  NomeDescrição
Método públicoHttpResponseInfraestrutura. Inicializa uma nova instância da classe HttpResponse.
Superior
  NomeDescrição
Propriedade públicaBufferObtém ou define um valor que indica se o buffer de saída e enviá-lo após a resposta completa é concluída processamento.
Propriedade públicaBufferOutputObtém ou define um valor que indica se o buffer de saída e enviá-lo após a página completa concluir o processamento.
Propriedade públicaCacheObtém a diretiva de cache (como a expiração de tempo, as configurações de privacidade e variar cláusulas) de uma página da Web.
Propriedade públicaCacheControlObtém ou define o Cache-Control cabeçalho HTTP, que corresponde a um do HttpCacheability valores de enumeração.
Propriedade públicaCharsetObtém ou define o conjunto de caracteres do fluxo de saída HTTP.
Propriedade públicaClientDisconnectedTokenObtém um CancellationToken objeto é retirado quando o cliente se desconecta.
Propriedade públicaContentEncodingObtém ou define o conjunto de caracteres do fluxo de saída HTTP.
Propriedade públicaContentTypeObtém ou define o tipo MIME de HTTP do fluxo de saída.
Propriedade públicaCookiesObtém a coleção de cookies de resposta.
Propriedade públicaExpiresObtém ou define o número de minutos antes de expira uma página 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 é fornecida para compatibilidade com versões anteriores do ASP.
Propriedade públicaExpiresAbsoluteObtém ou define o absoluta data e hora em que remover informações armazenadas em cache do cache. ExpiresAbsolute é fornecida para compatibilidade com versões anteriores do ASP.
Propriedade públicaFilterObtém ou define um filtro de quebra automática de objeto que é usado para modificar o corpo da entidade HTTP antes da transmissão.
Propriedade públicaHeaderEncodingObtém ou define um Encoding fluxo de saída do objeto que representa a codificação para o cabeçalho atual.
Propriedade públicaHeadersObtém a coleção de cabeçalhos de resposta.
Propriedade públicaIsClientConnectedObtém um valor indicando se o cliente ainda está conectado ao servidor.
Propriedade públicaIsRequestBeingRedirectedObtém um valor booleano indicando se o cliente está sendo transferido para um novo local.
Propriedade públicaOutputPermite a saída de texto para o fluxo de resposta HTTP de saída.
Propriedade públicaOutputStreamPermite que binário saída para o corpo de conteúdo saída HTTP.
Propriedade públicaRedirectLocationObtém ou define o valor de Http Location cabeçalho.
Propriedade públicaStatusConjuntos de Status linha é retornada ao cliente.
Propriedade públicaStatusCodeObtém ou define o código de status HTTP de saída retornado ao cliente.
Propriedade públicaStatusDescriptionObtém ou define a seqüência de status HTTP de saída retornada ao cliente.
Propriedade públicaSubStatusCodeObtém ou define um valor que o código de status da resposta de qualificação.
Propriedade públicaSupportsAsyncFlushObtém um valor que indica se a conexão oferece suporte a operações assíncronas de liberação.
Propriedade públicaSuppressContentObtém ou define um valor que indica se deseja enviar HTTP conteúdo para o cliente.
Propriedade públicaSuppressFormsAuthenticationRedirectObtém ou define um valor que especifica se o redirecionamento de autenticação de formulários para a página de login deve ser substituído.
Propriedade públicaTrySkipIisCustomErrorsObtém ou define um valor que especifica se IIS 7.0 erros personalizados estão desabilitados.
Superior
  NomeDescrição
Método públicoAddCacheDependencyAssocia um conjunto de dependências de cache a resposta para facilitar invalidação da resposta se ele é armazenado no cache de saída e alterar as dependências especificadas.
Método públicoAddCacheItemDependencies(ArrayList)Torna a validade de uma resposta em cache dependente de outros itens no cache.
Método públicoAddCacheItemDependencies(String[])Torna a validade de um item em cache dependente de outro item no cache.
Método públicoAddCacheItemDependencyTorna a validade de uma resposta em cache dependente de outro item no cache.
Método públicoAddFileDependencies(ArrayList)Adiciona um grupo de nomes de arquivo à coleção de nomes de arquivo do qual a resposta atual é dependente.
Método públicoAddFileDependencies(String[])Adiciona uma matriz de nomes de arquivo à coleção de nomes de arquivo do qual a resposta atual é dependente.
Método públicoAddFileDependencyAdiciona um único nome de arquivo à coleção de nomes de arquivo do qual a resposta atual é dependente.
Método públicoAddHeaderAdiciona um cabeçalho HTTP para o fluxo de saída. AddHeader é fornecida para compatibilidade com versões anteriores do ASP.
Método públicoAppendCookieInfraestrutura. Adiciona um cookie HTTP à coleção de cookie intrínseca.
Método públicoAppendHeaderAdiciona um cabeçalho HTTP para o fluxo de saída.
Método públicoAppendToLogAdiciona informações de log personalizado para o arquivo de log do Internet Information Services (IIS).
Método públicoApplyAppPathModifierAdiciona uma identificação de sessão para o caminho virtual se a sessão estiver usando Cookieless estado da sessão e retorna o caminho combinado. Se Cookieless estado de sessão não for usado, ApplyAppPathModifier retorna o caminho virtual original.
Método públicoBeginFlushEnvia a resposta atualmente no buffer para o cliente.
Método públicoBinaryWriteGrava uma cadeia de caracteres binários no fluxo de saída HTTP.
Método públicoClearLimpa todo o conteúdo de saída do fluxo de buffer.
Método públicoClearContentLimpa todo o conteúdo de saída do fluxo de buffer.
Método públicoClearHeadersLimpa todos os cabeçalhos do fluxo de buffer.
Método públicoCloseFecha a conexão de soquete para um cliente.
Método públicoDisableKernelCacheDesabilita o cache de kernel para a resposta atual.
Método públicoDisableUserCacheDesabilita o cache de modo de usuário do IIS para esta resposta.
Método públicoEndEnvia todas as saídas em buffer no momento para o cliente, interrompe a execução da página e eleva o EndRequest eventos.
Método públicoEndFlushConclui uma operação assíncrona de liberação.
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método públicoFlushEnvia todas as saídas em buffer no momento para o cliente.
Método públicoGetHashCodeServe como uma função hash para um tipo específico. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoPicsAcrescenta um HTTP PICS-Label cabeçalho para o fluxo de saída.
Método públicoRedirect(String)Redireciona uma solicitação para um novo URL e especifica a nova URL.
Método públicoRedirect(String, Boolean)Redireciona um cliente para um novo URL. Especifica a nova URL e se deve terminar a execução da página atual.
Método públicoRedirectPermanent(String)Executa um redirecionamento permanente da URL solicitada para a URL especificada.
Método públicoRedirectPermanent(String, Boolean)Executa um redirecionamento permanente da URL solicitada para o URL especificado e fornece a opção para completar a resposta.
Método públicoRedirectToRoute(Object)Redireciona uma solicitação para um novo URL usando valores de parâmetro de rota.
Método públicoRedirectToRoute(RouteValueDictionary)Redireciona uma solicitação para um novo URL usando valores de parâmetro de rota.
Método públicoRedirectToRoute(String)Redireciona uma solicitação para um novo URL usando um nome de rota.
Método públicoRedirectToRoute(String, Object)Redireciona uma solicitação para um novo URL usando valores de parâmetros de rota e um nome de rota.
Método públicoRedirectToRoute(String, RouteValueDictionary)Redireciona uma solicitação para um novo URL usando valores de parâmetros de rota e um nome de rota.
Método públicoRedirectToRoutePermanent(Object)Executa um redirecionamento permanente de uma URL solicitada para um novo URL usando valores de parâmetro de rota.
Método públicoRedirectToRoutePermanent(RouteValueDictionary)Executa um redirecionamento permanente de uma URL solicitada para um novo URL usando valores de parâmetro de rota.
Método públicoRedirectToRoutePermanent(String)Executa um redirecionamento permanente de uma URL solicitada para um novo URL usando um nome de rota.
Método públicoRedirectToRoutePermanent(String, Object)Executa um redirecionamento permanente de uma URL solicitada para um novo URL usando os valores de parâmetro de rota e o nome da rota que correspondem a nova URL.
Método públicoRedirectToRoutePermanent(String, RouteValueDictionary)Executa um redirecionamento permanente de uma URL solicitada para um novo URL usando valores de parâmetros de rota e um nome de rota.
Método públicoMembro estáticoRemoveOutputCacheItem(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.
Método públicoMembro estáticoRemoveOutputCacheItem(String, String)Usa o provedor especificado do cache de saída para remover todos os itens do cache de saída que estão associados com o caminho especificado.
Método públicoSetCookieInfraestrutura. Atualiza um cookie existente na coleção cookies.
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Método públicoTransmitFile(String)Grava o arquivo especificado diretamente um fluxo de saída de resposta HTTP, sem armazenamento em buffer na memória.
Método públicoTransmitFile(String, Int64, Int64)Grava a parte especificada de um arquivo diretamente para um fluxo de saída de resposta HTTP, sem armazenamento em buffer na memória.
Método públicoWrite(Char)Grava um caractere em um fluxo de saída de resposta HTTP.
Método públicoWrite(Object)Grava um Object um fluxo de resposta HTTP.
Método públicoWrite(String)Grava uma cadeia de caracteres em um fluxo de saída de resposta HTTP.
Método públicoWrite(Char[], Int32, Int32)Grava uma matriz de caracteres em um fluxo de saída de resposta HTTP.
Método públicoWriteFile(String)Grava o conteúdo do arquivo especificado diretamente para um fluxo de saída de resposta HTTP como um bloco de arquivo.
Método públicoWriteFile(String, Boolean)Grava o conteúdo do arquivo especificado diretamente para um fluxo de saída de resposta HTTP como um bloco de memória.
Método públicoWriteFile(IntPtr, Int64, Int64)Grava o arquivo especificado diretamente um fluxo de saída de resposta HTTP.
Método públicoWriteFile(String, Int64, Int64)Grava o arquivo especificado diretamente um fluxo de saída de resposta HTTP.
Método públicoWriteSubstitutionPermite a inserção de blocos de substituição de resposta em resposta, o que permite a geração dinâmica de regiões de resposta especificado para respostas de saída em cache.
Superior

Os métodos e propriedades do HttpResponse classe são expostos por meio de Response propriedade do HttpApplication, HttpContext, Page, e UserControl classes.

Há suporte para apenas em cenários de postagem e não em cenários de postagens assíncronas dos seguintes métodos da classe HttpResponse:

Atualizações de página parcial estão habilitadas quando você usa UpdatePanel controles para atualizar regiões selecionadas de uma página em vez de atualizar a página inteira com um postback. Para obter mais informações, consulte UpdatePanel Control Overview e Partial-Page Rendering Overview.

TopicLocation
Como: PASS Values Between Páginas Web ASP.NETdv_aspnetcon
Como: Passar valores entre páginas da Web do ASP.NETBuilding ASP .NET Web Applications in Visual Studio
Como: Passar valores entre páginas da Web ASP.NETdv_vwdcon

O exemplo a seguir desenha três retângulos sobrepostos quando a página é solicitada. O código começa definindo a ContentType propriedade image/jpeg, para que a página inteira será processada como uma imagem JPEG. O código chama o Clear método para garantir que nenhum conteúdo estranha é enviado com essa resposta. Em seguida, o código define a BufferOutput propriedade como true para que a página é processada completamente antes de ser enviado ao cliente solicitante. Dois objetos usados para desenhar retângulos, são criados: um Bitmap e um Graphics objeto. As variáveis criadas na página são usadas como coordenadas para desenhar retângulos e uma seqüência de caracteres que aparece dentro do retângulo maior.

Quando três retângulos e a seqüência de caracteres exibida dentro deles são desenhadas, o Bitmap salvos para o Stream objeto associado com o OutputStream propriedade e seu formato é definido como JPEG. O código chama o Dispose e Dispose métodos para liberar os recursos usados por dois objetos de desenho. Por fim, o código chama o Flush método para enviar a resposta em buffer para o cliente solicitante.

ObservaçãoObservação

No código, o HttpResponse objeto é chamado da palavra-chave Response. Por exemplo, Response.Clear() se refere a HttpResponse.Clear método. O Page classe possui uma propriedade chamada Response que expõe a instância atual do 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

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.
Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Isso foi útil para você?
(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR
© 2013 Microsoft. Todos os direitos reservados.