包含要求快取的組態資訊。
Syntax
class RequestCachingSection : ConfigurationSection
方法
下表列出 類別所 RequestCachingSection 公開的方法。
| 名稱 | 描述 |
|---|---|
| GetAllowDefinition | (繼承自 ConfigurationSection.) |
| GetAllowLocation | (繼承自 ConfigurationSection。) |
| RevertToParent | (繼承自 ConfigurationSection。) |
| SetAllowDefinition | (繼承自 ConfigurationSection。) |
| SetAllowLocation | (繼承自 ConfigurationSection。) |
屬性
下表列出 類別所 RequestCachingSection 公開的屬性。
| 名稱 | 描述 |
|---|---|
DefaultFtpCachePolicy |
FtpCachePolicySettings值,指定本機電腦的預設 FTP 快取行為。 |
DefaultHttpCachePolicy |
HttpCachePolicySettings值,指定本機電腦的預設 HTTP 快取行為。 |
DefaultPolicyLevel |
指定預設快取原則層級的讀取/寫入 sint32 值。 可能的值稍後會列在一節中。 |
DisableAllCaching |
讀取/寫入 boolean 值。 如果停用本機電腦上的快取則為 true,否則為 false。 注意: 如果此組態屬性在任何組態檔中設定 true 為 ,則會全域停用快取,而且會忽略所有其他快取相關設定。 |
IsPrivateCache |
讀取/寫入 boolean 值。 true 如果本機電腦快取是私人 (,則提供使用者隔離) ;否則為 false 。 注意: 在用戶端電腦上,此值通常會設定為 true ,這表示某個使用者無法使用其他使用者快取的資源。 針對仲介層應用程式,此值通常會設定為 false 。 |
Location |
(繼承自 ConfigurationSection .) 索引鍵屬性。 |
Path |
(繼承自 ConfigurationSection .) 索引鍵屬性。 |
SectionInformation |
(繼承自 ConfigurationSection。) |
UnspecifiedMaximumAge |
讀取/寫入 datetime 值,指定沒有到期資訊之快取資源的預設最長存留期。 預設為 1 天。 設定此屬性可確保沒有到期標頭資訊的資源不會無限期地保留在快取中。 |
子類別
這個類別不包含子類別。
備註
下表列出 屬性的可能值 DefaultPolicyLevel 。 預設值為 1 (BypassCache) 。
| 值 | 關鍵字 | 描述 |
|---|---|---|
| 0 | Default |
使用資源的快取複本,或將資源要求傳送至伺服器,以滿足資源要求。 採取的動作要由目前的快取原則和快取中內容的保留期限決定。 大部分的應用程式都應該使用此快取層級。 |
| 1 | BypassCache |
使用伺服器滿足要求。 用戶端與伺服器之間沒有任何項目取得自快取、加入快取或從快取移除。 這是.NET Framework隨附的電腦群組態檔中指定的預設快取行為。 |
| 2 | CacheOnly |
使用本機快取的資源滿足要求;不會傳送不在快取中的專案要求。 指定此快取原則層級時,如果專案不在用戶端快取中,則會擲回 WebException 例外狀況。 |
| 3 | CacheIfAvailable |
如果資源可用,則從快取滿足資源要求,否則會將資源要求傳送至伺服器。 如果本機快取中沒有要求的專案可用,但在用戶端與伺服器之間的快取中,中繼快取就會滿足要求。 |
| 4 | Revalidate |
如果時間戳記與伺服器上的資源時間戳記相同,請使用資源的快取複本來滿足要求;否則,資源會從伺服器下載、呈現給呼叫端,並儲存在快取中。 |
| 5 | Reload |
使用伺服器滿足要求。 回應可能會儲存在快取中,視快取控制指示詞的設定 no-cache 和 Pragma: no-cache HTTP 快取通訊協定中的標頭而定。 |
| 6 | NoCacheNoStore |
絕不會使用快取中的資源滿足要求,而且不會快取資源。 如果資源出現在本機快取中,則會將其移除。 這個原則層級表示中繼快取應當移除資源。 在 HTTP 快取通訊協定中,這是使用 no-cache 快取控制指示詞來達成。 |
繼承階層架構
RequestCachingSection
規格需求
| 類型 | Description |
|---|---|
| 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 |
另請參閱
ConfigurationSection 類別
FtpCachePolicySettings 類別
HttpCachePolicySettings 類別
System.Net.Cache.RequestCacheLevel 列舉
System.Net.WebException 類別
CIM_DATETIME