HttpResponse.AppendHeader(String, String) Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

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

public:
 void AppendHeader(System::String ^ name, System::String ^ value);

public void AppendHeader (string name, string value);

member this.AppendHeader : string * string -> unit

Public Sub AppendHeader (name As String, value As String)

Parâmetros

name

String

O nome do cabeçalho HTTP para adicionar ao fluxo de saída.

value

String

A cadeia de caracteres a ser acrescentada ao cabeçalho.

Exceções

HttpException

O cabeçalho será anexado depois que os cabeçalhos HTTP tiverem sido enviados.

Exemplos

O exemplo a seguir chama o AppendHeader método para adicionar um cabeçalho personalizado ao HttpResponse objeto enviado ao cliente solicitante.

Response.AppendHeader("CustomAspNetHeader", "Value1");

Response.AppendHeader("CustomAspNetHeader", "Value1")

Comentários

Se você usar o AppendHeader método para enviar cabeçalhos específicos do cache e, ao mesmo tempo, usar o modelo de objeto de cache (Cache) para definir a política de cache, os cabeçalhos de resposta HTTP que pertencem ao cache (Cache-Control, Expires, Last-Modified, Pragmae Vary) poderão ser excluídos quando o modelo de objeto de cache for usado. Esse comportamento permite que ASP.NET mantenha as configurações mais restritivas. Por exemplo, considere uma página que inclui controles de usuário. Se esses controles tiverem políticas de cache conflitantes, a política de cache mais restritiva será usada. Se um controle de usuário definir o cabeçalho "Cache-Control: Public" e outro controle de usuário definir o cabeçalho mais restritivo "Cache-Control: Private" por meio de chamadas para SetCacheability, o cabeçalho "Cache-Control: Private" será enviado com a resposta.

Para obter uma lista de cabeçalhos HTTP/1.1 padrão, consulte Definições de campo de cabeçalho.