快取之 outputCacheProfiles 的 add 項目 (ASP.NET 設定結構描述)

發行項
05/28/2012

將 OutputCacheProfile 物件加入至組態集合。快取設定檔只能從頁面的 @ OutputCache 指示詞中參考。使用者控制項或伺服器控制項上不支援設定檔。

<add name="String" 
     enabled="true|false" 
     duration="number" 
     location="Any|Client|Downstream|Server|None|ServerAndClient" 
     sqlDependency="String" 
     varyByCustom="String" 
     varyByControl="String" 
     varyByHeader="String" 
     varyByParam="String" 
     noStore="true|false" />

屬性和項目

下列章節會說明屬性、子項目和父項目。

屬性

屬性	描述
name	必要的 String 屬性。設定快取設定檔的唯一名稱。
enabled	選擇性 Boolean 屬性。啟用設定檔的輸出快取。
duration	選擇性 TimeSpan 屬性。設定頁面在快取中儲存的秒數。
location	選擇性 Int32 屬性。決定允許儲存快取回應的位置。
sqlDependency	選擇性 String 屬性。設定頁面層級 SQL 快取相依性。
varyByCustom	選擇性 String 屬性。設定呼叫頁面的 varyByCustom 時使用的字串。
varyByControl	選擇性 String 屬性。設定呼叫 varyByControl 時快取及使用的控制項 ID。也可以設定為 ID 的分號分隔清單。
varyByHeader	選擇性 String 屬性。命名用於更改快取輸出的分號分隔標頭集合。
varyByParam	選擇性 String 屬性。命名用於更改快取輸出的分號分隔參數集合。
noStore	選擇性 Boolean 屬性。設定值，表示是否在快取頁面的回應中傳送 "Cache-Control: no-store" 指示詞。

子項目

無。

父項目

項目	描述
configuration	Common Language Runtime 和 .NET Framework 應用程式所使用之每一個組態檔中的必要根項目。
system.web	在組態檔中，指定 ASP.NET 組態設定的根項目。包含設定 ASP.NET Web 應用程式和控制該應用程式之行為方式的組態項目。
caching	設定 Web 應用程式的快取設定。
outputCacheSettings	指定可套用至 ASP.NET 應用程式中頁面的輸出快取設定。
outputCacheProfiles	包含幾組快取設定，這些設定可以套用到要指定 OutputCache 指示詞的頁面中。

備註

預設組態

下列預設 add 項目沒有在電腦組態檔或根目錄 Web.config 檔中明確設定，但它卻是 .NET Framework 2.0 版中應用程式所傳回的預設組態。

<add name = "" 
  enabled = "true" 
  duration = "-1" 
  location = "" 
  sqlDependency = "" 
  varyByCustom = "" 
  varyByControl = "" 
  varyByHeader = "" 
  varyByParam = "" 
  noStore = "false"/>

範例

下列範例只花一分鐘快取伺服器上的頁面，並根據瀏覽器類型和主要版本儲存不同版本的頁面。

<outputCacheSettings>
  <outputCacheProfiles>
    <add name="ServerOnly" 
         duration="60" 
         varyByCustom="browser" 
         location="Server" />
  </outputCacheProfiles>
</outputCacheSettings>

在設計需要以這種方式快取的頁面時，您將需要對頁面加入下列指示詞：

<%@ OutputCache CacheProfile="ServerOnly" %>

如需詳細資訊，請參閱 @ OutputCache。

項目資訊

組態區段處理常式	System.Web.Configuration.OutputCacheSettingsSection
組態成員	OutputCacheSettingsSection.OutputCacheProfiles
可設定的位置	Machine.config 根層次 Web.config 應用程式層級 Web.config
需求	IIS 5.0、5.1 和 6.0 版 .NET Framework 2.0 版 Visual Studio 2005

請參閱

共用方式為

快取之 outputCacheProfiles 的 add 項目 (ASP.NET 設定結構描述)

屬性和項目

屬性

子項目

父項目

備註

預設組態

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源