HttpResponse.AppendHeader(String, String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將 HTTP 標頭加入輸出資料流。
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)
參數
- name
- String
要加入輸出資料流的 HTTP 標頭名稱。
- value
- String
附加到標頭的字串。
例外狀況
標頭在 HTTP 標頭送出之後被附加。
範例
下列範例會 AppendHeader 呼叫 方法,將自訂標頭新增至 HttpResponse 傳送至要求用戶端的物件。
Response.AppendHeader("CustomAspNetHeader", "Value1");
Response.AppendHeader("CustomAspNetHeader", "Value1")
備註
如果您使用 AppendHeader 方法來傳送快取特定標頭,同時使用快取物件模型 (Cache) 來設定快取原則,則使用快取物件模型時,可能會刪除快取物件模型時,與快取 (Cache-Control
、 Expires
、 Last-Modified
、 Pragma
和 Vary
) 相關的 HTTP 回應標頭。 此行為可讓 ASP.NET 維持最嚴格的設定。 例如,請考慮包含使用者控制項的頁面。 如果這些控制項有衝突的快取原則,則會使用最嚴格的快取原則。 如果一個使用者控制項設定標頭 「 Cache-Control: Public
」,而另一個使用者控制項透過呼叫 SetCacheability 來設定更嚴格的標頭 「 Cache-Control: Private
」,則會使用回應傳送 「 Cache-Control: Private
」 標頭。
如需標準 HTTP/1.1 標頭的清單,請參閱 標頭欄位定義。