控制網路請求的快取機制。
<configuration>
<system.net>
<requestCaching>
語法
<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>
屬性和項目
下列章節說明屬性、子元素和父元素。
Attributes
| Attribute | Description |
|---|---|
isPrivateCache |
指定快取是否能隔離不同使用者的資訊。 預設值是 true。 這個數值應該是 false 針對中階應用。 |
disableAllCaching |
規定所有網路回應都關閉快取功能,且無法透過程式化覆蓋。 |
defaultPolicyLevel |
列舉中的 RequestCacheLevel 一個數值。 預設值是 BypassCache。 |
unspecifiedMaximumAge |
指定內容預設過期時間點。 |
policyLevel 屬性
| 價值觀 | Description |
|---|---|
Default |
若資源是新鮮的、內容長度準確,且有到期、修改及內容長度屬性,則回傳快取資源。 |
BypassCache |
從伺服器回傳資源。 |
CacheOnly |
若內容長度存在且條目大小相符,則回傳快取資源。 |
CacheIfAvailable |
若提供內容長度且與條目大小相符,則回傳快取資源;否則,資源會從伺服器下載並返回呼叫者。 |
Revalidate |
若快取資源的時間戳記與伺服器資源的時間戳相同,則回傳快取資源;否則,資源會從伺服器下載,儲存在快取中,然後返回給呼叫者。 |
Reload |
從伺服器下載資源,儲存在快取中,然後將資源回傳給呼叫者。 |
NoCacheNoStore |
如果存在快取資源,該資源會被刪除。 資源會從伺服器下載並返回給呼叫者。 |
Revalidate |
若時間戳記與伺服器資源的時間戳相同,則透過快取的資源副本滿足請求;否則,資源會從伺服器下載,呈現給呼叫者,並儲存在快取中, |
子元素
| 元素 | Description |
|---|---|
| defaultHttpCachePolicy | 可選元素。 說明 HTTP 快取是否啟用,並說明預設快取政策。 |
| <defaultFtpCachePolicy> 元素(網路設定) | 可選元素。 說明 FTP 快取是否啟用,並說明預設快取政策。 |
父項目
| 元素 | Description |
|---|---|
| system.net | 包含指定 .NET Framework 如何連接網路的設定。 |
Example
以下範例說明如何停用所有快取。
<configuration>
<system.net>
<requestCaching
disableAllCaching="true"
/>
</system.net>
</configuration>