<requestCaching> 元素 (網路設定)
控制網路要求的快取機制。
<設定>
<system.net>
<requestCaching>
Syntax
<requestCaching
isPrivateCache ="true|false"
disableAllCaching="true|false"
defaultPolicyLevel="BypassCache|Default|CacheOnly|CacheIfAvailable|Revalidate|Reload|NoCacheNoStore|Revalidate"
unspecifiedMaximumAge= "d.hh:mm:ss">
<defaultHttpCachePolicy>...</defaultHttpCachePolicy>
<defaultFtpCachePolicy>...</defaultFtpCachePolicy>
</requestCaching>
屬性和項目
下列章節說明屬性、子元素和父元素。
屬性
屬性 | 描述 |
---|---|
isPrivateCache |
指定快取在不同使用者資訊之間是否有所隔離。 預設值是 true 。 針對中介層應用程式,此值應為 false 。 |
disableAllCaching |
指定停用所有 Web 回應的快取,而且無法以程式設計方式覆寫。 |
defaultPolicyLevel |
RequestCacheLevel 列舉中的其中一個值。 預設值是 BypassCache 。 |
unspecifiedMaximumAge |
指定預設時間,在此時間之後標示內容為過期。 |
policyLevel 屬性
值 | 描述 |
---|---|
Default |
若資源為全新、內容長度正確,並存在到期、修改與內容長度屬性,則傳回快取的資源。 |
BypassCache |
從伺服器傳回資源。 |
CacheOnly |
若內容長度存在且符合輸入大小,則傳回快取的資源。 |
CacheIfAvailable |
若提供內容長度並符合輸入大小,則傳回快取資源;否則,從伺服器下載資源,並傳回呼叫端。 |
Revalidate |
若快取資源的時間戳記等同於伺服器資源的時間戳記,則傳回快取資源;否則,從伺服器下載資源,儲存在快取,並傳回呼叫端。 |
Reload |
從伺服器下載資源、儲存在快取,並將其傳回呼叫端。 |
NoCacheNoStore |
若快取的資源存在,則會將其刪除。 會從伺服器下載資源,並傳回呼叫端。 |
Revalidate |
若時間戳記等同於伺服器資源的時間戳記,則使用資源的快取複本來滿足要求,否則,從伺服器下載資源,呈現給呼叫端,並儲存在快取。 |
子元素
元素 | 描述 |
---|---|
defaultHttpCachePolicy | 選擇性項目。 說明 HTTP 快取是否為作用中,並說明預設快取原則。 |
<defaultFtpCachePolicy> 元素 (網路設定) | 選擇性項目。 說明 FTP 快取是否為作用中,並說明預設快取原則。 |
父項目
元素 | 描述 |
---|---|
system.net | 包含會指定 .NET Framework 如何連接至網路的設定。 |
範例
下列範例示範如何停用所有快取。
<configuration>
<system.net>
<requestCaching
disableAllCaching="true"
/>
</system.net>
</configuration>