HttpResponse.AppendHeader(String, String) Methode

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Fügt dem Ausgabestream einen HTTP-Header hinzu.

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)

Parameter

name

String

Der Name des HTTP-Headers, der dem Ausgabestream hinzugefügt werden soll.

value

String

Die Zeichenfolge, die an den Header angefügt werden soll.

Ausnahmen

HttpException

Der Header wurde nach dem Senden der HTTP-Header hinzugefügt.

Beispiele

Im folgenden Beispiel wird die AppendHeader -Methode aufgerufen, um dem an den anfordernden Client gesendeten HttpResponse Objekt einen benutzerdefinierten Header hinzuzufügen.

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

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

Hinweise

Wenn Sie die AppendHeader -Methode verwenden, um cachespezifische Header zu senden und gleichzeitig das Cacheobjektmodell (Cache) zum Festlegen der Cacherichtlinie zu verwenden, können HTTP-Antwortheader, die sich auf die Zwischenspeicherung (Cache-Control, , , Pragmaund Vary) beziehen, ExpiresLast-Modifiedgelöscht werden, wenn das Cacheobjektmodell verwendet wird. Dieses Verhalten ermöglicht es ASP.NET, die restriktivsten Einstellungen beizubehalten. Betrachten Sie beispielsweise eine Seite, die Benutzersteuerelemente enthält. Wenn diese Steuerelemente konfliktierende Cacherichtlinien aufweisen, wird die restriktivste Cacherichtlinie verwendet. Wenn ein Benutzersteuerelement den Header "Cache-Control: Public" und ein anderes Benutzersteuerelement den restriktiveren Header "Cache-Control: Private" über Aufrufe von SetCacheabilityfestlegt, wird der Header "Cache-Control: Private" mit der Antwort gesendet.

Eine Liste der HTTP/1.1-Standardheader finden Sie unter Headerfelddefinitionen.