HttpResponse.AppendHeader(String, String) Metoda

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.dll

Dodaje nagłówek HTTP do strumienia wyjściowego.

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)

Parametry

name

String

Nazwa nagłówka HTTP, który ma zostać dodany do strumienia wyjściowego.

value

String

Ciąg, który ma być dołączany do nagłówka.

Wyjątki

HttpException

Nagłówek jest dołączany po wysłaniu nagłówków HTTP.

Przykłady

Poniższy przykład wywołuje metodę w AppendHeader celu dodania niestandardowego nagłówka do obiektu wysłanego do HttpResponse klienta wysyłającego żądanie.

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

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

Uwagi

Jeśli używasz AppendHeader metody do wysyłania nagłówków specyficznych dla pamięci podręcznej i jednocześnie używasz modelu obiektów pamięci podręcznej (Cache) do ustawiania zasad pamięci podręcznej, nagłówki odpowiedzi HTTP dotyczące buforowania (Cache-Control, , Expires``Last-Modified, Pragmai Vary) mogą zostać usunięte, gdy używany jest model obiektów pamięci podręcznej. To zachowanie umożliwia ASP.NET zachowanie najbardziej restrykcyjnych ustawień. Rozważmy na przykład stronę zawierającą kontrolki użytkownika. Jeśli te kontrolki mają sprzeczne zasady pamięci podręcznej, zostaną użyte najbardziej restrykcyjne zasady pamięci podręcznej. Jeśli jedna kontrolka użytkownika ustawia nagłówek "Cache-Control: Public", a inna kontrolka użytkownika ustawia bardziej restrykcyjny nagłówek "Cache-Control: Private" za pośrednictwem wywołań do SetCacheability, nagłówek "Cache-Control: Private" zostanie wysłany z odpowiedzią.

Aby uzyskać listę standardowych nagłówków HTTP/1.1, zobacz Definicje pól nagłówka.