頁面級緩衝@ OutputCache

       最近要用到緩衝，所以才去找了相關資料，開始在一個使用者控制項頭加入@ OutputCache指令，發現第一次進入頁面是對了，第二次再進入時就出錯了。鬱悶……
這裡@ OutputCache的一些參數說明:

       以聲明的方式控制 ASP.NET 頁或頁中包含的使用者控制項的輸出緩衝策略。有關輸出緩衝的更多資訊，請參見 ASP.NET 緩衝功能。

<%@ OutputCache Duration="#ofseconds" Location="Any | Client | Downstream | Server | None" Shared="True | False" VaryByControl="controlname" VaryByCustom="browser | customstring" VaryByHeader="headers" VaryByParam="parametername" %>

一、屬性

Duration
頁或使用者控制項進行緩衝的時間（以秒計）。在頁或使用者控制項上設定該屬性為來自對象的 HTTP 響應建立了一個到期策略，並將自動快取頁面或使用者控制項輸出。
注意   該屬性是必需的。如果未包含該屬性，將出現分析器錯誤。

Location
OutputCacheLocation 枚舉值之一。預設值為 Any。
警告   包含在使用者控制項（.ascx 檔案）中的 @ OutputCache 指令不支援此屬性。

Shared
一個布爾值，確定使用者控制項輸出是否可以由多個頁共用。預設值為 false。有關詳細資料，請參見備忘部分。
注意   包含在 ASP.NET 頁（.aspx 檔案）中的 @ OutputCache 指令不支援此屬性。

VaryByCustom
表示自訂輸出緩衝要求的任意文本。如果賦予該屬性的值是 browser，緩衝將隨瀏覽器名稱和主要版本資訊的不同而不同。如果輸入了自訂字串，您必須在應用程式的 Global.asax 檔案中重寫 HttpApplication.GetVaryByCustomString 方法。

VaryByHeader
分號分隔的 HTTP 標題列表，用於使輸出緩衝發生變化。當將該屬性設為多標題時，對於每個指定的標題，輸出緩衝都包含一個請求文檔的不同版本。
注意   設定 VaryByHeader 屬性在所有 HTTP 1.1 緩衝中啟用快取項目，而不僅限於 ASP.NET 緩衝。使用者控制項中的 @ OutputCache 指令不支援此屬性。

VaryByParam
分號分隔的字串列表，用於使輸出緩衝發生變化。預設情況下，這些字串與用 GET 方法屬性發送的查詢字串值對應，或與用 POST 方法發送的參數對應。當將該屬性設定為多參數時，對於每個指定的參數，輸出緩衝都包含一個請求文檔的不同版本。可能的值包括 none、* 和任何有效查詢字串或 POST 參數名稱。
警告   在輸出緩衝 ASP.NET 頁時，該屬性是必需的。它對於使用者控制項也是必需的，除非已經在使用者控制項的 @ OutputCache 指令中包含了 VaryByControl 屬性。如果沒有包含它，則發生分析器錯誤。如果您不想使緩衝內容隨任何指定參數發生變化，請將該值設為 none。如果要使輸出緩衝根據所有參數值發生變化，請將屬性設定為 *。

VaryByControl
一個分號分隔的字串列表，用於更改使用者控制項的輸出緩衝。這些字串代表在使用者控制項中聲明的 ASP.NET 伺服器控制項的 ID 屬性值。有關詳細資料，請參見緩衝 ASP.NET 頁的某些部分。
注意   除非已經包含了 VaryByParam 屬性，否則在使用者控制項 @ OutputCache 指令中，該屬性是必需的。ASP.NET 頁中的 @ OutputCache 指令不支援該屬性。

二、備忘
為頁輸出緩衝設定值與通過 HttpResponse.Cache 屬性操作 HttpCachePolicy.SetExpires 和 HttpCachePolicy.SetCacheability 方法相同。如果在建立使用者控制項時設定 VaryByParam 屬性，可實現該控制項的部分頁緩衝。

如果 Web Form頁要求使用者查看授權，則輸出緩衝將 Cache-Control HTTP 標題設定為 private。有關所有這些主題的詳細資料，請參見緩衝 ASP.NET 頁。

如果將 Shared 屬性設定為 true，則緩衝的使用者控制項輸出可以被多個 Web Form頁訪問。如果不設定為 true，預設行為是為包含使用者控制項的每一頁緩衝使用者控制項輸出的一個版本。通過啟用 Shared 屬性，可以潛在地節省大量的記憶體。有關詳細資料，請參見緩衝 ASP.NET 頁的某些部分。

三、樣本
下面的樣本說明了如何設定頁或使用者控制項進行輸出緩衝的期間。

<%@ OutputCache Duration="100" VaryByParam="none" %>
下一個樣本說明了如何指示輸出緩衝來對頁或使用者控制項進行緩衝，此緩衝處理是根據來自表單的 POST 或來自查詢字串的位置和計數表單參數進行的。每個收到的具有不同位置或計數參數（或兩者）的 HTTP 要求都進行 10 秒的緩衝處理。帶有相同參數值的任何後繼請求都將從緩衝中得到滿足，直至超過輸入的緩衝期。

<%@ OutputCache Duration="100" VaryByParam="location;count" %>