Freigeben über


HttpResponse.AppendHeader-Methode

Fügt dem Ausgabestream einen HTTP-Header hinzu.

Namespace: System.Web
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Sub AppendHeader ( _
    name As String, _
    value As String _
)
'Usage
Dim instance As HttpResponse
Dim name As String
Dim value As String

instance.AppendHeader(name, value)
public void AppendHeader (
    string name,
    string value
)
public:
void AppendHeader (
    String^ name, 
    String^ value
)
public void AppendHeader (
    String name, 
    String value
)
public function AppendHeader (
    name : String, 
    value : String
)

Parameter

  • name
    Der Name des HTTP-Headers, der dem Ausgabestream hinzugefügt werden soll.
  • value
    Die Zeichenfolge, die an den Header angefügt werden soll.

Ausnahmen

Ausnahmetyp Bedingung

HttpException

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

Hinweise

Wenn Sie mithilfe der AppendHeader-Methode cachespezifische Header senden und gleichzeitig mit dem Cache-Objektmodell (Cache) die Cacherichtlinie festlegen, können beim Verwenden des Cacheobjektmodells die HTTP-Antwortheader gelöscht werden, die sich auf Caching beziehen (Cache-Control, Expires, Last-Modified, Pragma und Vary). Durch dieses Verhalten kann ASP.NET die am weitesten einschränkenden Einstellungen beibehalten. Angenommen, eine Seite enthält Benutzersteuerelemente. Wenn für diese Steuerelemente Konflikte bzgl. der Cacherichtlinien bestehen, wird die Cacherichtlinie mit den meisten Einschränkungen verwendet. Wenn ein Benutzersteuerelement den Header "Cache-Control: Public" und ein anderes den eingeschränkteren Header "Cache-Control: Private" über Aufrufe von SetCacheability festlegt, wird mit der Antwort der Header "Cache-Control: Private" gesendet.

Beispiel

Im folgenden Codebeispiel wird eine AppendHeader-Methode aufgerufen, mit der dem HttpResponse-Objekt ein benutzerdefinierter Header hinzugefügt werden soll, das an den anfordernden Client gesendet wird.

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HttpResponse-Klasse
HttpResponse-Member
System.Web-Namespace