設定指定要求延伸模組的快取。
Syntax
class CachingProfileElement : CollectionElement
方法
這個類別不包含方法。
屬性
下表列出 類別所 CachingProfileElement 公開的屬性。
| 名稱 | 描述 |
|---|---|
Duration |
讀取/寫入 datetime 值，指定回應應該保留在快取中的時間量。 預設值為 30 秒。 有效的時間範圍是從 0 到 365 天。 |
Extension |
必要的唯一讀取/寫入 string 值，指定將使用快取設定檔的要求延伸。 延伸模組的格式必須是 「EXT」 或 「*」，其中 EXT 是延伸模組。 索引鍵屬性。 注意： 不允許重迭的擴充專案。 每個要求都對應至一個 CachingProfileElement 物件。 如果具有 「*」 的專案存在，具有更特定擴充功能的其他快取設定檔將會以星號覆寫設定檔。 設定檔專案的排序並不重要。 |
KernelCachePolicy |
可設定核心快取原則的讀取/寫入 sint32 值。 可能的值稍後會列在一節中。 |
Location |
讀取/寫入 sint32 值，指定輸出快取的可能位置。 可能的值稍後會列在一節中。 |
Policy |
可設定輸出快取原則的讀取/寫入 sint32 值。 可能的值稍後會列在一節中。 |
VaryByHeaders |
讀取/寫入 string 值，其中包含伺服器將用來變更 URL 快取回應的逗號分隔標頭名稱清單。 |
VaryByQueryString |
讀取/寫入 string 值，其中包含伺服器將用來變更 URL 快取回應的查詢字串參數名稱逗號分隔清單。 |
子類別
這個類別不包含子類別。
備註
這個類別會對應至 <profiles> ApplicationHost.config 檔案中 區段下 <system.webServer/caching> 的專案。 這個類別的實例包含在 ProfilesCachingProfileSettings 類別的陣列屬性中。
下表列出 屬性的可能值 KernelCachePolicy 。 預設值為 0 (DontCache) 。
| 值 | 關鍵字 | 描述 |
|---|---|---|
| 0 | DontCache |
回應不會在核心中快取。 不過，仍會發生輸出快取。 注意： 此設定會覆寫 屬性中的任何 Location 衝突設定。 |
| 1 | CacheUntilChange |
回應會在HTTP.SYS快取中快取，直到專案失效，或直到屬性所 Duration 指定無活動期間之後到期為止。 |
| 2 | CacheForTimePeriod |
即使專案在過渡期間失效，回應也會快取屬性所 Duration 指定的時間量。 |
| 3 | DisableCache |
快取已停用，而且不會發生任何快取。 |
下表列出 屬性的可能值 Location 。 預設值為 3 (Server) 。
| 值 | 關鍵字 | 描述 |
|---|---|---|
| 0 | Any |
回應可以在用戶端、Web 服務器或 Proxy 伺服器上快取。 |
| 1 | Client |
回應只會在用戶端上快取。 |
| 2 | Downstream |
回應會在 Proxy 伺服器和用戶端上快取，但不會在 Web 服務器上快取。 |
| 3 | Server |
回應只會在 Web 服務器上快取。 |
| 4 | None |
回應不會在任何地方快取。 |
| 5 | ServerAndClient |
回應會在 Web 服務器和用戶端上快取，但不會在 Proxy 伺服器上快取。 注意： 當伺服器對私人內容有不同的行為時，您可以使用此設定來避免在 Proxy 快取上的多個使用者之間共用內容。 |
下表列出 屬性的可能值 Policy 。 預設值為 0 (DontCache) 。
| 值 | 關鍵字 | 描述 |
|---|---|---|
| 0 | DontCache |
回應不會放在輸出快取中。 不過，核心快取仍會發生。 |
| 1 | CacheUntilChange |
回應會快取到專案失效，或直到在 屬性所 Duration 指定無活動期間之後到期為止。 |
| 2 | CacheForTimePeriod |
即使專案在過渡期間失效，回應也會快取屬性所 Duration 指定的時間量。 |
| 3 | DisableCache |
快取已停用，而且不會發生任何快取。 |
範例
下列範例會顯示預設網站的所有 CachingProfileElement 物件。
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Get the caching section for the default Web site.
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")
oSite.GetSection "CachingSection", oSection
' Display the path and location.
Wscript.Echo "Path: " & oSection.Path
Wscript.Echo "Location: " & oSection.Location
Wscript.Echo
' Display all of the caching profiles for the default Web site.
For Each oCachingProfileElement In oSection.Profiles.Profiles
Wscript.Echo
WScript.Echo "[ " & oCachingProfileElement.Extension & _
" ] Caching Profile"
WScript.Echo "-----------------------------------"
WScript.Echo "Duration: " & oCachingProfileElement.Duration
WScript.Echo "KernelCachePolicy: " & _
CachePolicyText(oCachingProfileElement.KernelCachePolicy)
WScript.Echo "Location: " & _
LocationText(oCachingProfileElement.Location)
WScript.Echo "Policy: " & _
CachePolicyText(oCachingProfileElement.Policy)
WScript.Echo "VaryByHeaders: " & _
oCachingProfileElement.VaryByHeaders
WScript.Echo "VaryByQueryString: " & _
oCachingProfileElement.VaryByQueryString
WScript.Echo
Next
' Provide text for KernelCachePolicy and Policy enumeration values.
Function CachePolicyText(enumval)
Select Case enumval
Case 0
CachePolicyText="DontCache"
Case 1
CachePolicyText="CacheUntilChange"
Case 2
CachePolicyText="CacheForTimePeriod"
Case 3
CachePolicyText="DisableCache"
Case Else
CachePolicyText="Undefined enumeration value"
End Select
End Function
' Provide text for Location enumeration values.
Function LocationText(enumval)
Select Case enumval
Case 0
LocationText="Any"
Case 1
LocationText="Client"
Case 2
GetLocationText="Downstream"
Case 3
LocationText="Server"
Case 4
LocationText="None"
Case 5
LocationText="ServerAndClient"
Case Else
LocationText="Undefined enumeration value"
End Select
End Function
繼承階層架構
CachingProfileElement
規格需求
| 類型 | 描述 |
|---|---|
| Client | - Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10上的 IIS 10.0 |
| 伺服器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016上的 IIS 10.0 |
| 產品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF 檔案 | WebAdministration.mof |
另請參閱
AspCache 類別
CachingProfileSettings 類別
CachingSection 類別
CollectionElement 類別
HttpClientCache 類別