HttpResponse.AppendHeader(String, String) Метод

Определение

Пространство имен:

System.Web

Сборка:

System.Web.dll

Добавляет заголовок HTTP в выходной поток.

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)

Параметры

name

String

Имя заголовка HTTP, добавляемого в выходной поток.

value

String

Строка, добавляемая к заголовку.

Исключения

HttpException

Заголовок добавляется после отправки заголовков HTTP.

Примеры

В следующем примере метод вызывается AppendHeader для добавления пользовательского заголовка в HttpResponse объект, отправленный клиенту запроса.

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

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

Комментарии

Если вы используете AppendHeader метод для отправки заголовков, относящихся к кэшу, и в то же время используется объектная модель кэша (Cache) для установки политики кэша, заголовки ответов HTTP, относящиеся к кэшированию (Cache-Control, Expires, Last-ModifiedPragmaиVary) могут быть удалены при использовании объектной модели кэша. Это поведение позволяет ASP.NET поддерживать самые строгие параметры. Например, рассмотрим страницу, включающую элементы управления пользователем. Если эти элементы управления имеют конфликтующие политики кэша, будет использоваться самая строгая политика кэша. Если один элемент управления пользователя задает заголовок "Cache-Control: Public" и другой элемент управления пользователем задает более строгий заголовок "Cache-Control: Private" через вызовы SetCacheability, то заголовок "Cache-Control: Private" будет отправлен с ответом.

Список стандартных заголовков HTTP/1.1 см. в определениях полей заголовков.