?????? 最近要用到緩存,所以才去找了相關資料,開始在一個用戶控件頭加入@ 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 窗體頁要求用戶查看授權,則輸出緩存將 Cache-Control HTTP 標頭設置為 private。有關所有這些主題的詳細信息,請參見緩存 ASP.NET 頁。
如果將 Shared 屬性設置為 true,則緩存的用戶控件輸出可以被多個 Web 窗體頁訪問。如果不設置為 true,默認行為是為包含用戶控件的每一頁緩存用戶控件輸出的一個版本。通過啟用 Shared 屬性,可以潛在地節省大量的內存。有關詳細信息,請參見緩存 ASP.NET 頁的某些部分。
三、示例
下面的示例說明了如何設置頁或用戶控件進行輸出緩存的持續時間。
<%@ OutputCache Duration="100" VaryByParam="none" %>
下一個示例說明了如何指示輸出緩存來對頁或用戶控件進行緩存,此緩存處理是根據來自窗體的 POST 或來自查詢字符串的位置和計數窗體參數進行的。每個收到的具有不同位置或計數參數(或兩者)的 HTTP 請求都進行 10 秒的緩存處理。帶有相同參數值的任何后繼請求都將從緩存中得到滿足,直至超過輸入的緩存期。
<%@ OutputCache Duration="100" VaryByParam="location;count" %>