以聲明的方式控制 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 頁的某些部分。

示例
下面的示例說明了如何設置頁或用戶控件進行輸出緩存的持續時間。

<%@ OutputC