HttpResponse.AppendHeader(String, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 a ser adicionado ao fluxo de saída.
- value
- String
A cadeia de caracteres a ser acrescentada ao cabeçalho.
Exceções
O cabeçalho é acrescentado depois que os cabeçalhos HTTP são 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, , Expirese Last-ModifiedPragmaVary) 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 inclua 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, SetCacheabilityo 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 cabeçalho.