HttpResponse.AppendHeader(String, String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 -> unitPublic 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 string para anexar ao cabeçalho.
Exceções
O cabeçalho é adicionado depois de os cabeçalhos HTTP terem sido enviados.
Exemplos
O exemplo seguinte chama o AppendHeader método para adicionar um cabeçalho personalizado ao HttpResponse objeto enviado ao cliente requerente.
Response.AppendHeader("CustomAspNetHeader", "Value1");
Response.AppendHeader("CustomAspNetHeader", "Value1")
Observações
Se usar o AppendHeader método para enviar cabeçalhos específicos da cache e, ao mesmo tempo, usar o modelo de objetos de cache (Cache) para definir a política de cache, os cabeçalhos de resposta HTTP que dizem respeito à cache (Cache-Control, Expires, Last-Modified, Pragma, e Vary) podem ser eliminados quando o modelo de objeto cache for utilizado. Este comportamento permite que o ASP.NET mantenha as definições mais restritivas. Por exemplo, considere uma página que inclui controlos do utilizador. Se esses controlos tiverem políticas de cache conflitantes, será utilizada a política de cache mais restritiva. Se um controlo de utilizador definir o cabeçalho "Cache-Control: Public" e outro controlo de utilizador definir o cabeçalho mais restritivo "Cache-Control: Private" via chamadas para SetCacheability, então o cabeçalho "Cache-Control: Private" será enviado com a resposta.
Para uma lista de cabeçalhos HTTP/1.1 padrão, veja Definições de campos de cabeçalho.