HttpResponse.AppendHeader(String, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет заголовок НТТР в поток вывода.
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
Имя заголовка НТТР, который добавляется в поток вывода.
- value
- String
Строка, которую требуется добавить в заголовок.
Исключения
Заголовок добавляется после отправки заголовков HTTP.
Примеры
В следующем примере вызывается AppendHeader метод для добавления пользовательского заголовка в объект, HttpResponse отправляемый запрашивающим клиенту.
Response.AppendHeader("CustomAspNetHeader", "Value1");
Response.AppendHeader("CustomAspNetHeader", "Value1")
Комментарии
Если вы используете AppendHeader метод для отправки заголовков, относящихся к кэшу, и в то же время используете объектную модель кэша (Cache) для задания политики кэша, заголовки HTTP-ответа, относящиеся к кэшированию (Cache-Control
, Expires
, Last-Modified
, Pragma
и Vary
), могут быть удалены при использовании объектной модели кэша. Такое поведение позволяет ASP.NET поддерживать самые строгие параметры. Например, рассмотрим страницу с пользовательскими элементами управления. Если эти элементы управления имеют конфликтующие политики кэша, будет использоваться наиболее ограничительная политика кэша. Если один пользовательский элемент управления задает заголовок "Cache-Control: Public
", а другой — более строгий заголовок "Cache-Control: Private
" с помощью вызовов SetCacheability, то заголовок "Cache-Control: Private
" будет отправлен вместе с ответом.
Список стандартных заголовков HTTP/1.1 см. в разделе Определения полей заголовков.