HttpResponse.AppendHeader(String, String) HttpResponse.AppendHeader(String, String) HttpResponse.AppendHeader(String, String) HttpResponse.AppendHeader(String, String) Method

Definition

Fügt dem Ausgabestream einen HTTP-Header hinzu.Adds an HTTP header to the output stream.

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 String String String

Der Name des HTTP-Headers, der dem Ausgabestream hinzugefügt werden soll.The name of the HTTP header to add to the output stream.

value
String String String String

Die Zeichenfolge, die an den Header angefügt werden soll.The string to append to the header.

Ausnahmen

Der Header wurde nach dem Senden der HTTP-Header hinzugefügt.The header is appended after the HTTP headers have been sent.

Beispiele

Im folgenden Beispiel wird die AppendHeader -Methode aufgerufen, um dem HttpResponse an den anfordernden Client gesendeten-Objekt einen benutzerdefinierten Header hinzuzufügen.The following example calls the AppendHeader method to add a custom header to the HttpResponse object sent to the requesting client.

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

Hinweise

Wenn Sie AppendHeader die-Methode verwenden, um Cache spezifische Header zu senden, und gleichzeitig das Cache-ObjektmodellCache() verwenden, um Cache Richtlinien, HTTP-Antwortheader, die dasCache-ControlCaching betreffen Last-Modified(, Expires,, Pragma, und Vary) werden möglicherweise gelöscht, wenn das Cache-Objektmodell verwendet wird.If you use the AppendHeader method to send cache-specific headers and at the same time use the cache object model (Cache) to set cache policy, HTTP response headers that pertain to caching (Cache-Control, Expires, Last-Modified, Pragma, and Vary) might be deleted when the cache object model is used. Dieses Verhalten ermöglicht ASP.net, die restriktivsten Einstellungen beizubehalten.This behavior enables ASP.NET to maintain the most restrictive settings. Stellen Sie sich beispielsweise eine Seite vor, die Benutzer Steuerelemente enthält.For example, consider a page that includes user controls. Wenn diese Steuerelemente widersprüchliche Cache Richtlinien aufweisen, wird die restriktivste Cache Richtlinie verwendet.If those controls have conflicting cache policies, the most restrictive cache policy will be used. Wenn ein Benutzer Steuerelement den-HeaderCache-Control: Publicfestlegt und ein anderes Benutzer Steuerelement den restriktiverenCache-Control: PrivateHeader "" über SetCacheabilityAufrufe von festlegt,Cache-Control: Privatewird der Header "" mit der Antwort gesendet.If one user control sets the header "Cache-Control: Public" and another user control sets the more restrictive header "Cache-Control: Private" via calls to SetCacheability, then the "Cache-Control: Private" header will be sent with the response.

Eine Liste der HTTP/1.1-Standard Header finden Sie in Abschnitt 14, "Header Feld Definitionen" in der Spezifikation " Hypertext Transfer Protocol--HTTP/1.1 " auf der World Wide Web Consortium-Website (W3C).For a list of standard HTTP/1.1 headers, see section 14, "Header Field Definitions," in the Hypertext Transfer Protocol -- HTTP/1.1 specification on the World Wide Web Consortium (W3C) Web site.

Gilt für: