HttpResponse.AppendHeader(String, String) Methode

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Fügt dem Ausgabedatenstrom 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 Ausgabedatenstrom hinzugefügt werden soll.

value

String

Die Zeichenfolge, die an die Kopfzeile angefügt werden soll.

Ausnahmen

HttpException

Der Header wird angefügt, nachdem die HTTP-Header gesendet wurden.

Beispiele

Im folgenden Beispiel wird die AppendHeader Methode aufgerufen, um dem objekt, das HttpResponse an den anfordernden Client gesendet wird, 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, werden HTTP-Antwortheader zum Zwischenspeichern (Cache-Control, Expires, , Last-Modified, Pragmaund Vary) möglicherweise gelöscht, wenn das Cacheobjektmodell verwendet wird. Mit diesem Verhalten können ASP.NET die restriktivsten Einstellungen beibehalten. Betrachten Sie beispielsweise eine Seite, die Benutzersteuerelemente enthält. Wenn diese Steuerelemente widersprüchliche Cacherichtlinien aufweisen, wird die restriktivste Cacherichtlinie verwendet. Wenn ein Benutzersteuerelement die Kopfzeile "Cache-Control: Public" festlegt und ein anderes Benutzersteuerelement die restriktivere Kopfzeile "Cache-Control: Private" über Aufrufe SetCacheabilityfestlegt, wird der Header "Cache-Control: Private" mit der Antwort gesendet.

Eine Liste der standardmäßigen HTTP/1.1-Header finden Sie unter Headerfelddefinitionen.